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随 着 我 国 高 等 教育 规模 的 扩大 以 及 产业 结构 调整 的 进一步 完善 ,社会 对 高 层次 应 用 型 
人 才 的 需求 将 更 加 迫切。 各 地 高 校 紧 密 结合 地 方 经 济 建设 发 展 需要 ,科学 运用 市 场 调 节 机 
制 ,合理 调整 和 配置 教育 资源 ,在 改革 和 改造 传统 学 科 专 业 的 基础 上 ,加 强 工程 型 和 应 用 型 
学 科 专 业 建 设 , 积 极 设置 主要 面向 地 方 支柱 产业 、 高 新 技术 产业 、 服 务 业 的 工程 型 和 应 用 型 
学 科 专 业 ,积极 为 地 方 经 济 建设 输送 各 类 应 用 型 人 才 。 各 高 校 加 大 了 使 用 信息 科学 等 现代 
科学 技术 提升 改造 传统 学 科 专 业 的 力度 ,从 而 实现 传统 学 科 专 业 向 工程 型 和 应 用 型 学 科 专 
业 的 发 展 与 转变 。 在 发 挥 传统 学 科 专 业 师 资 力量 强 、 办 学 经 验 丰 富 .教学 资源 充裕 等 优势 的 
同时 ,不 断 更 新 教学 内 容 、 改 革 课 程 体系 ,使 工程 型 和 应 用 型 学 科 专 业 教 育 与 经 济 建设 相 适 
应 。 计 算 机 课程 教学 在 从 传统 学 科 向 工程 型 和 应 用 型 学 科 转 变 中 起 着 至 关 重 要 的 作用 , 工 
程 型 和 应 用 型 学 科 专 业 中 的 计算 机 课程 设置 .内 容 体系 和 教学 手段 及 方法 等 也 具有 不 同 于 
传统 学 科 的 鲜明 特点 。 

为 了 配合 高 校 工程 型 和 应 用 型 学 科 专 业 的 建设 和 发 展 ,急需 出 版 一 批 内 容 新 、 体 系 新 、 
方法 新 、 手 段 新 的 高 水 平 计算 机 课程 教材 。 目 前 ,工程 型 和 应 用 型 学 科 专 业 计 算 机 课程 教材 
的 建设 工作 仍 滞后 于 教学 改革 的 实践 ,如 现 有 的 计算 机 教材 中 有 不 少 内 容 陈 旧 ( 依 然 用 传统 
专业 计算 机 教材 代替 工程 型 和 应 用 型 学 科 专 业 教 材 ) , 重 理论 , 轻 实践 ,不 能 满足 新 的 教学 计 
划 、 课 程 设置 的 需要 ; 一 些 课程 的 教材 可 供 选 择 的 品种 太 少 ; 一 些 基础 课 的 教材 虽然 品种 
较 多 ,但 低 水 平 重复 严重 ; 有 些 教材 内 容 庞 杂 , 书 越 编 越 厚 ; 专业 课 教材 .教学 辅助 教材 及 
教学 参考 书 短缺 ,等 等 ,都 不 利于 学 生 能 力 的 提高 和 素质 的 培养 。 为 此 ,在 教育 部 相关 教学 
指导 委员 会 专家 的 指导 和 建议 下 ,清华 大 学 出 版 社 组 织 出 版 本 系列 教材 ,以 满足 工程 型 和 应 
用 型 学 科 专业 计算 机 课程 教学 的 需要 。 本 系列 教材 在 规划 过 程 中 体现 了 如 下 一 些 基 本 原则 
和 特点 。 

(1) 面向 工程 型 与 应 用 型 学 科 专业 ,强调 计算 机 在 各 专业 中 的 应 用 。 教 材 内 容 坚 持 基 
本 理论 适度 ,反映 基本 理论 和 原理 的 综合 应 用 ,强调 实践 和 应 用 环节 。 

(2) 反映 教学 需要 ,促进 教学 发 展 。 教 材 规 划 以 新 的 工程 型 和 应 用 型 专业 目录 为 依据 。 
教材 要 适应 多 样 化 的 教学 需要 ,正确 把 握 教学 内 容 和 课程 体系 的 改革 方向 ,在 选择 教材 内 容 
和 编写 体系 时 注意 体现 素质 教育 、 创 新 能 力 与 实践 能 力 的 培养 ,为 学 生 知识 、 能 力 、 素 质 协调 
发 展 创造 条 件 。 

G) 实施 精品 战略 ,突出 重点 ,保证 质量 。 规 划 教 材 建设 仍然 把 重点 放 在 公共 基础 课 和 
专业 基础 课 的 教材 建设 上 ; 特别 注意 选择 并 安排 一 部 分 原来 基础 比较 好 的 优秀 教材 或 讲义 
修订 再 版 ,逐步 形成 精品 教材 ; 提倡 并 鼓励 编写 体现 工程 型 和 应 用 型 专业 教学 内 容 和 课程 
体系 改革 成 果 的 教材 。 
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CD 主张 一 纲 多 本 ,合理 配套 。 基 础 课 和 专业 基础 课 教材 要 配套 ,同一 门 课程 可 以 有 多 
本 具有 不 同 内 容 特 点 的 教材 。 处 理 好 教材 统一 性 与 多 样 化 ,基本 教材 与 辅助 教材 ,教学 参考 
书 , 文 字 教材 与 软件 教材 的 关系 ,实现 教材 系列 资源 配套 。 

(5) 依靠 专家 ,择优 选用 。 在 制订 教材 规划 时 要 依靠 各 课程 专家 在 调查 研究 本 课程 教 
材 建 设 现状 的 基础 上 提出 规划 选 题 。 在 落实 主编 人 选 时 ,要 引入 竞争 机 制 ,通过 申报 ,评审 
确定 主编 。 书 稿 完成 后 要 认真 实行 审 稿 程序 ,确保 出 书 质量 。 

繁荣 教材 出 版 事业 ,提高 教材 质量 的 关键 是 教师 。 建 立 一 支 高 水 平 的 以 老 带 新 的 教材 
编写 队伍 才能 保证 教材 的 编写 质量 和 建设 力度 ,希望 有 志 于 教材 建设 的 教师 能 够 加 入 到 我 
们 的 编写 队伍 中 来 。 


21 世纪 高 等 学 校 计 算 机 教育 实用 规划 教材 编 委 会 
联系 人 : 魏 江 江 weijj@tup. tsinghua. edu. cn 
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PHP 语言 是 目前 国内 外 最 普及 、 使 用 最 广泛 的 互联 网 开发 语言 之 一 , 它 不 仅 具 有 功能 
丰富 、 表 达能 力 强 ,使 用 方便 灵活 ,执行 效率 高 .可 移植 性 好 等 优点 ,而 且 具 有 开放 的 源 代码 、 
多 数据 库 支持 、 面 向 对 象 支 持 、 容 易学 习 、 完 全 免费 等 特点 , 越 来 越 受 欢迎 ,正在 逐渐 成 为 
Web 应 用 开发 的 主流 语言 。Zend Framework 作为 PHP 的 官方 框架 ,充分 发 挥 了 PHP i 
言 的 特点 ,所 采用 的 面向 对 象 技术 、 前 端 控 制 技术 以 及 MVC 程序 设计 模式 更 是 极 大 地 提高 
T Web 项 目的 开发 效率 ,并 且 使 应 用 程序 的 扩展 与 维护 变 得 异常 简单 与 容易 ,是 大 .中 型 
Web 应 用 的 理想 开发 框架 。 

本 书 的 写作 背景 基于 以 下 两 个 方面 : 一 是 专业 教育 的 需要 ; 二 是 实际 项 目的 驱使 。 目 
前 进行 的 高 等 教育 课程 改革 更 加 关注 学 生 综 合 应 用 能 力 的 培养 以 及 课程 设置 与 市 场 需要 的 
匹配 。 因 此 ,在 高 校 计 算 机 科学 技术 专业 教育 中 新 增 了 大 量 的 实践 与 选修 课程 ,用 于 培养 学 
生 综合 应 用 基础 理论 知识 的 能 力 ,我 们 在 教学 过 程 中 深 深 感到 了 这 方面 教材 的 芽 乏 。 另 外 ， 
作者 在 教学 之 余 还 主持 并 参与 了 多 项 软件 产品 的 研发 工作 。 本 书 案例 项 目 就 是 来 自 于 实际 
项 目 一 一 XX 办 公 自 动 化 管理 系统 ,是 其 简化 版 本 。 该 项 目 针 对 某 大 学 的 一 所 独立 学 院 , 使 
用 了 目前 Web 应 用 开发 中 应 用 最 广 的 PHP Zend Framework 框架 等 网 络 编程 的 主流 技术 ， 
把 该 项 目 作 为 一 个 教学 案例 ,无 论 是 从 技术 性 、 综 合 性 ,还 是 从 规范 性 、 完 整 性 方面 都 是 非常 
合适 的 。 目 前 ,PHP 虽然 正在 逐渐 成 为 Web 应 用 开发 的 主流 语言 ,但 高 校 的 计算 机 专业 教 
学 体系 中 却 很 少 设置 相关 的 课程 ,本 书 的 出 版 会 弥补 这 方面 的 不 足 。 

本 书 案例 项 目 实现 了 办 公 自 动 化 管理 系统 的 常用 功能 ,包括 用 户 信息 管理 访问 控制 管 
理 、 公 文 信息 管理 .事务 信息 管理 .新 闻 资 讯 管理 .留言 信息 管理 以 及 公共 服务 管理 中 的 用 户 
网 络 空间 .日 程 安排 .工作 日 志 、 数 据 备份 .系统 日 志 等 。 本 书 以 这 些 系统 功能 的 实现 过 程 为 
依托 ,由浅 入 深 、 循 序 渐进 地 介绍 了 Zend Framework 框架 的 基本 结构 .运行 原理 .开发 环境 
配置 以 及 Zend_Navigation Sli, Zend. Form 表单 .Zend_Db Xi E, Zend_Acl 访问 控制 、 
Zend Cache 缓存 等 组 件 技术 。 全 书 共 分 12 章 , 内 容 如 下 : 

第 1 章 主要 介绍 采用 PHP 的 Zend Framework 框架 进行 项 目 开发 前 的 一 些 准备 工作 ， 
包括 对 Zend Framework 框架 的 简单 认识 、 开 发 环境 的 搭建 与 配置 .常用 开发 工具 Zend 
Studio 和 Notepad 十 十 的 使 用 等 。 

第 2 章 详细 介绍 Zend Framework 框架 的 基本 结构 及 运行 原理 ,并 对 框架 的 几 个 重要 
文件 进行 简单 的 分 析 。 本 章 内 容 是 项 目 开 发 的 理论 基础 ,其 中 的 MVC 机 制 更 是 后 续 学 习 


PHP Zend Framework 5t A F E 2 € sl 308 


的 主线 。 

第 3 章 是 系统 概述 及 总 体 设计 。 本 章 从 软件 工程 的 角度 简要 地 介绍 了 Web 应 用 开发 
的 一 般 步 又 ,包括 系统 分 析 、 系 统 设计 、 数 据 库 设计 以 及 公共 文件 设计 等 内 容 。 

第 4 章 介绍 系统 的 页 面 设 计 方 法 及 Zend Framework 的 布局 模式 ,主要 内 容 包括 系统 
初始 设置 .CSS 样式 概述 、 典 型 页 面 设计 以 及 Zend_Layout 布局 模板 。 

第 5 章 介绍 Zend Framework 的 导航 及 数据 库 操作 ,通过 系统 新 闻 资 讯 管理 模块 的 实 
现 详细 讲解 Zend Framework 框架 的 Zend_Navigation 及 Zend_Db 组 件 技术 。 

第 6 章 通过 用 户 登 录 与 注册 功能 的 实现 ,介绍 Zend Framework 表单 的 创建 ,设置 及 处 
理 技术 。Zend_Form 表单 与 传统 的 HTML 表单 相 比 ,具有 无 与 伦比 的 技术 优势 ,是 实现 人 
机 交互 ,保证 信息 安全 ,减少 代码 元 余 的 最 佳 技术 方案 。 

第 7 章 主要 介绍 Zend Framework 框架 的 模块 技术 以 及 数据 库 的 增 、 删 、 改 、 查 等 详细 
操作 方法 。 本 章 既是 对 第 5 章 内 容 的 进一步 阐述 与 扩充 ,也 是 对 前 面 其 他 章节 知识 的 一 个 
实际 应 用 。 

第 8 章 介 绍 公文 信息 管理 功能 的 实现 ,包括 公文 的 添加 、 分 类 检索 .状态 跟踪 等 。 该 功 
能 是 办 公正 动 化 管理 系统 的 核心 功能 ,涉及 的 内 容 繁杂 ,业务 逻辑 也 相对 复杂 。 

第 9 章 介 绍 留言 信息 管理 功能 的 实现 ,内 部 留言 系统 是 应 用 系统 内 部 用 户 之 间 短 暂 交 
流 与 沟通 的 平台 , 它 综合 了 常用 即时 通信 工具 及 邮件 系统 的 特点 ,是 办 公 自 动 化 管理 系统 中 
不 可 或 缺 的 功能 模块 。 

第 10 章 介绍 事务 信息 管理 功能 的 实现 ,包括 数据 库 的 设计 、 事 务 的 添加 、 事 务 的 分 类 显 
示 、 事 务 提 醒 、 批 示 回 复 以 及 事务 处 理 状态 跟踪 等 。 本 章 的 事务 添加 采用 了 Zend 
Framework 的 视图 助手 , 它 是 一 种 Web 表单 创建 的 新 的 解决 方案 。 

第 11 章 介 绍 办 公 自 动 化 管理 系统 中 常用 办 公 功 能 的 实现 ,包括 用 户 网 络 空间 日程 安 
排 的 创建 与 管理 。 用 户 网 络 空间 类 似 于 一 个 简单 的 资源 管理 器 ,能 够 进行 文件 夹 的 创建 与 
删除 ,文件 的 复制 与 粘贴 等 基本 功能 。 

第 12 章 实现 办 公 自 动 化 管理 系统 的 访问 控制 、 缓 存 等 Web 应 用 的 安全 ,性 能 优化 技术 
方案 ,并 对 系统 进行 了 简要 的 完善 ,包括 图 形 验证 码 .系统 日 志 、 数 据 备份 等 。 

本 书 的 主要 特色 如 下 : 

(1) 技术 先进 ,使 用 广泛 。 

本 书 介 绍 的 Zend Framework 框架 技术 在 目前 网 络 应 用 开发 中 被 广泛 使 用 。 它 作为 
PHP 网 络 应 用 开发 的 官方 框架 ,拥有 非常 庞大 的 用 户 基础 和 国际 项 级 的 开发 人 员 支 持 , 发 
展 稳 定 .前 景 良好 。 

(2) 案例 完整 .实用 性 强 。 

本 书 案例 是 一 个 实际 项 目的 简化 版 本 , 稍 做 改进 与 完善 即 可 应 用 到 实际 项 目的 开发 中 。 

(3) 内 容 翔 实 , 循 序 渐进 。 

本 书 紧 紧 围绕 应 用 实例 ,从 软件 工程 的 角度 出 发 ,按照 项 目 开发 的 顺序 全 面 地 介绍 程序 
开发 规范 及 流程 ,使 读者 在 很 短 的 时 间 内 即 可 掌握 Web 应 用 开发 的 步骤 与 常用 技术 。 


(4) 重点 突出 ,难点 分 散 。 

本 书 以 介绍 Zend Framework 框架 技术 为 重点 ,主要 介绍 应 用 的 业务 处 理 逻 辑 的 实现 ， 
对 页 面 表现 技术 ,例如 CSS FÉ, JavaScript JQuery 等 技术 进行 了 略 化 处 理 。 每 章 突 出 一 
个 技术 难点 ,每 种 技术 的 介绍 均 以 从 应 用 到 原理 的 顺序 展开 ,让 读者 先 看 到 效果 ,然后 激发 
其 探究 “为 什么 ”的 兴趣 。 

(5) 由 浅 入 深 , 前 后 呼应 。 

Web 应 用 的 开发 是 一 个 基础 理论 知识 的 综合 应 用 过 程 ,会 涉及 很 多 方面 。 本 书 实例 功 
能 的 实现 采用 了 由 浅 入 深 、 逐 步 完善 的 方式 ,将 技术 难点 分 散 于 各 个 章节 中 ,做 到 了 叙述 上 
的 前 后 呼应 ,技术 上 的 逐步 加 深 。 

(6) 资源 丰富 ,探讨 方便 。 

为 帮助 读者 学 习 , 本 书 除 提供 源码 及 相关 工具 的 下 载 (清华 大 学 出 版 社 网 站 http:// 
www. tup. tsinghua. edu. cn) 外 ,还 创建 了 技术 支持 网 站 http://www. wmstudio. net. cn ,在 
这 里 读者 不 仅 可 以 看 到 案例 的 运行 效果 ,还 可 以 与 作者 进行 交流 ,并 对 相关 问题 进行 探讨 。 

本 书 是 一 本 Zend Framework 框架 的 入 门 级 实例 教程 ,适合 具备 PHP Web 应 用 开发 基 
础 .希望 学 习 框 架 技 术 来 提升 开发 能 力 的 读者 ,尤其 适合 掌握 了 基本 的 Web 编程 语言 和 面 
向 对 象 技术 ,但 还 没有 太 多 项 目 开 发 经 验 的 高 校 在 校 学 生 。 本 书 可 作为 高 等 院 校 计算 机 专 
业 实 践 及 选修 课程 .课程 设计 、 毕 业 设计 、 计 算 机 专业 培训 、 计 算 机 程序 设计 竞赛 的 教材 及 参 
考 书籍 ,同时 也 可 供 软件 开发 人 员 进 行 项 目 开 发 时 参考 。 

本 书 第 1 一 7 章 由 马 石 安 编写 ,第 8 一 12 章 由 魏 文 平 编写 ,所 有 图 片 的 配置 .代码 的 测试 
由 魏 文 平 完成 。 全 书 由 马 石 安 统一 修改 .整理 和 定稿 。 

在 编写 本 书 的 过 程 中 ,参考 和 引用 了 大 量 的 书籍 .文献 以 及 网 络 中 的 技术 资料 ,在 此 向 
这 些 文献 的 作者 表示 衷心 感谢 。 另 外 ,江汉 大 学 清华 大 学 出 版 社 的 领导 及 各 位 同仁 对 本 书 
的 编著 、 出 版 给 予 了 大 力 支 持 与 帮助 ,在 此 一 并 表示 感谢 。 由 于 作者 水 平 有 限 、 加 之 时 间 仓 
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第 1 章 Zend Framework 开发 环境 


Zend Framework 是 由 Zend Technologies 公司 支持 开发 的 完全 基于 PHP 5 的 开源 
PHP 项 目 开发 框架 ,可 用 于 Web 应 用 与 服务 的 开发 。 作 为 PHP 语言 的 标准 应 用 程序 框 
架 ,Zend Framework 采用 MVC 的 架构 模式 ,将 应 用 中 的 业务 逻辑 与 视图 进行 分 离 ,方便 了 
程序 的 开发 、 扩 展 与 维护 。 

本 章 介 绍 Zend Framework 项 目 开发 前 的 一 些 准备 工作 ,包括 开发 环境 的 配置 .常用 开 
发 工具 的 使 用 以 及 各 种 必 备 的 技术 资料 。 


1.1 Zend Framework 概述 


应 用 程序 框架 顾名思义 就 是 应 用 程序 的 基本 结构 ,也 指 应 用 程序 运行 的 基本 架构 类 库 。 
它 是 一 种 相对 固定 的 设计 模式 ,也 是 一 种 可 重用 的 、 半 完成 的 应 用 程序 。 使 用 框架 进行 项 目 
开发 ,可 以 让 开发 者 把 注意 力 更 多 地 集中 到 应 用 的 整体 结构 和 业务 逻辑 上 ,从 而 提高 项 目 开 
发 的 效率 与 质量 。 

Zend Framework 是 用 PHP 5. 3 及 更 高 版 本 开发 Web 应 用 和 服务 的 开源 框架 ,作为 一 
种 官方 的 ,热门 的 PHP 框架 技术 , 它 在 目前 的 PHP 项 目 开发 领域 受到 了 广泛 的 关注 与 青 
WE. Zend Framework 框架 采用 纯 面 向 对 象 技术 编码 实现 ,以 组 件 的 形式 进行 类 的 组 合 。 
其 组 件 结构 也 与 其 他 的 框架 不 同 , 采 用 了 松 耦 合 形式 ,每 个 组 件 几乎 不 依靠 其 他 组 件 。 这 
样 ,组 件 既 可 以 联合 使 用 也 可 以 独立 使 用 ,充分 发 挥 了 面向 对 象 技术 的 代码 重用 功能 ,减少 
了 程序 的 元 余 , 使 应 用 程序 更 加 强壮 与 稳健 。 


1.1.1 Zend Framework 的 特点 


1. 开发 公司 

Zend Technologies 公司 是 一 家 互联 网 基础 架构 软件 公司 ,成 立 于 1999 年 11 月 ,由 
Zeev Suraski 和 Andi Gutmans 两 位 开源 PHP 的 缔造 者 共同 创建 。 该 公司 总 部 设 在 美国 加 
利 福 尼 亚 州 的 库 比 蒂 诺 ,技术 中 心 设 在 以 色 列 特拉维夫 的 拉 马 特 甘 ,并 在 法 国 、 意 大 利 、 德 国 
等 多 个 国家 设 有 办 事 机 构 。 

Zend Technologies 公司 的 投资 商 是 包括 Azure Capital Partners, Index Ventures 和 
Platinum Venture Capita 在 内 的 非常 有 实力 的 投资 公司 。 更 为 重要 的 是 ,在 IT 行业 领先 的 
SAP 和 Intel 也 是 Zend 公司 的 投资 商 。 目 前 ,Zend 公司 已 经 得 到 了 来 自 IBM Oracle, Sun, 
Microsoft 公司 的 大 力 支 持 , 并 与 IBM, Oracle 达成 了 战略 合作 伙伴 关系 ,共同 推动 PHP 技 
术 的 发 展 。 
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Zend Technologies 公司 是 PHP 运行 引擎 Zend Engine 的 开发 商 , 它 的 两 个 奠基 人 
Andi Gutmans 和 Zeev Suraski 与 其 他 以 色 列 程序 员 一 起 发 展 了 由 Rasmus Lerdorf 开创 的 
PHP 语言 。 由 于 具有 国际 性 的 技术 权威 ,Zend 公司 和 他 的 创建 者 在 PHP 应 用 开发 以 及 开 
源 团体 中 持续 处 于 领导 的 核心 地 位 ,对 于 PHP. 技术 的 迅猛 发 展 起 到 了 强 有 力 的 推动 作用 ， 
并 且 为 企业 和 个 人 持续 提供 有 关 PHP 应 用 的 、 国 际 领先 的 ,专业 的 技术 解决 方案 。 

2. Zend Framework 的 优点 

Zend Framework 作为 PHP 的 官方 框架 ,不 仅 拥有 庞大 的 用 户 基 础 ,而 且 有 对 PHP 内 
部 构造 非常 熟悉 的 、 世 界 顶 级 的 开发 者 的 支持 ,因此 与 其 他 PHP 框架 相 比 , 它 具 有 更 高 的 
信赖 度 ,更 稳定 的 发 展 前 景 。 另 外 ,从 Zend 公司 对 Zend Framework 的 投入 来 看 ,中 断 对 
Zend Framework 的 支持 是 不 太 可 能 的 ,将 来 一 定 会 继续 对 Zend Framework 版 本 进行 升级 
与 补丁 修正 ,并 提供 良好 的 技术 支持 。 从 技术 的 角度 来 说 ,Zend Framework 还 具有 如 下 
TR. 

D 基于 PHP 建立 

Zend Framework 是 采用 PHP 编写 的 一 套 集成 开发 框架 ,可 以 说 是 从 PHP 中 来 ,到 
PHP 中 去 ,因而 与 运行 环境 具有 极 好 的 融合 性 ,在 所 有 PHP 框架 里 , 它 的 功能 强大 ,而 且 
稳健 。 

2) 面向 对 象 

PHP 支持 面向 对 象 的 开发 形式 ,特别 是 PHP 5 对 类 和 对 象 提 供 了 更 为 有 效 的 支持 。 
Zend Framework 是 纯正 的 OOP 框架 ,代码 严谨 .规范 ,对 PHP 的 侵入 性 要 比 其 他 框架 低 ， 
适合 多 人 联合 开发 。 

3) 使 用 MVC 模式 

MVC( 模 型 一 视图 一 控制 器 ) 开 发 模式 是 一 种 新 兴 的 Web 应 用 程序 开发 方式 ,使 用 此 
种 方式 可 以 实现 Web 页 面 表现 层 与 逻辑 层 的 分 离 。 这 样 ,应 用 程序 结构 层次 清晰 ,维护 、 扩 
展 方便 。 

4) 使 用 松 耦合 设计 

Zend Framework RHH A CUsc-at-wilD 设计, 每 个 组 件 几 乎 不 依赖 其 他 组 件 ,这 样 
可 以 让 开发 者 独立 使 用 组 件 , 扩 展 了 组 件 的 使 用 范围 。 

5) 多 数据 库 支持 

PDO(PHP Data Objects) 扩 展 为 PHP 访问 数据 库 定义 了 一 个 轻 量 级 的 ,一 致 性 的 接 
H , 它 提供 了 一 个 数据 访问 抽象 层 ,这 样 无 论 使 用 什么 数据 库 都 可 以 通过 一 致 的 函数 执行 查 
询 和 获取 数据 。 由 于 使 用 了 PDO 扩展 ,Zend Framework 支持 多 种 数据 库 , 例 如 MySQL、 
Oracle, IBM DB2 Microsoft SQL Server, PostgreSQL, SQLite 和 Informix Dynamic Server 等 。 

6) 多 邮件 系统 支持 

Zend Framework 支持 多 种 邮件 收发 系统 ,例如 MBox, Maildir, POP3 和 IMAP4 等 。 

7) 灵活 的 缓存 机 制 

Zend Framework 具有 非常 灵活 的 缓存 机 制 ,支持 多 种 缓存 方式 ,可 以 将 缓存 写 入 内 
存 、 文 件 或 数据 库 等 。 

8) 具有 开放 源 代码 贡献 者 

Zend Framework 秉承 了 开放 源 代码 的 特点 ,而 且 有 Zend 公司 作为 领导 者 的 大 量 PHP 


程序 员 参 与 了 此 项 工程 的 开发 ,这 样 ,Zend Framework 的 功能 会 越 来 越 强大 ,性 能 也 会 越 
来 越 稳定 。 

9) 由 贡献 者 负责 其 代码 的 知识 产权 

随 着 信息 技术 的 发 展 ,知识 产权 越 来 越 受 到 人 们 的 重视 。Zend Framework 作为 由 贡 
献 者 参与 的 开源 程序 ,参与 项 目 开 发 的 所 有 贡献 者 保证 他 们 所 使 用 的 代码 的 自主 知识 产权 。 

10) 宽松 的 认证 方式 

Zend Framework 采用 New BSD License 的 认证 方式 。New BSD License 认证 是 只 要 
使 用 者 在 代码 中 注 明 著作 权 就 可 以 自由 发 布 的 一 种 认证 方法 ,同时 也 是 所 有 认证 方式 中 限 
制 最 少 的 一 种 。Zend Framework 框架 的 源码 都 是 独立 编程 的 ,不 存在 Zend 公司 以 外 的 著 
作 权 拥有 者 ,因为 应 用 Zend Framework 构筑 的 系统 在 发 布 时 没有 任何 限制 .商用 的 情况 下 
也 不 必 担 心 侵 权 的 问题 。 

3. Zend Framework 的 缺点 

Zend Framework 框架 虽然 拥有 巨大 的 技术 优势 ,但 这 并 不 表示 它 是 PHP 应 用 开发 的 
唯一 选择 。 任 何事 物 都 不 是 完美 的 ,Zend Framework 也 有 很 明显 的 缺陷 。 

1) Zend Framework 源 文件 多 、 体 积 大 

由 于 Zend Framework 功能 强大 ,是 一 种 重量 级 的 企业 框架 ,所 以 它 的 源 文件 非常 多 ， 
下 载 压缩 包 的 体积 也 比较 大 。 这 与 某 些 轻 量 级 的 框架 相 比 ,Zend Framework 显得 有 些 腔 肿 。 

其 实在 下 载 的 压缩 包 里 有 许多 文件 并 不 属于 框架 本 身 , 例 如 示例 文件 .帮助 文档 以 及 功 
能 扩展 文件 等 。 另 外 ,Zend Framework 提供 精简 版 的 下 载 , 也 可 以 在 开发 中 根据 系统 需求 
删除 某 些 不 用 的 组 件 。 

2) Zend Framework 执行 速度 慢 

和 其 他 大 型 Web 框架 类 似 , Zend Framework 有 一 个 非常 庞大 的 前 端 控 制 器 (Front 
Controller) 。 但 由 于 PHP 运行 时 环境 的 特殊 性 , 即 每 次 请 求 都 是 独立 的 上 下 文 ,这 个 前 端 
控制 器 不 得 不 在 每 次 请 求 时 都 被 重新 初始 化 一 次 。 这 样 的 运行 方式 给 性 能 带 来 了 非常 大 的 
开销 ,这 也 被 认为 是 Zend Framework 的 性 能 瓶颈 所 在 。 另 外 ,与 前 端 控制 器 运行 方式 类 
似 ,在 Zend Framework 的 数据 库 操作 中 ,通过 Zend. Db 获取 数据 库 中 表 结 构 信 息 的 操作 ， 
也 是 每 次 请 求 都 要 重复 进行 的 动作 。 

事实 上 ,Zend_Db 可 以 通过 Memcached, A pc 等 类 似 的 外 部 缓存 器 来 缓存 表 结 构 , 但 前 
端 控制 器 设计 的 复杂 确实 不 是 缓存 可 以 解决 的 。 这 并 不 说 明 Zend Framework 设计 有 问 
题 ,而 是 说 明 并 不 是 所 有 的 项 目 、 应 用 都 适合 使 用 Zend Framework 框架 ,要 靠 项 目 开 发 者 
针对 自身 情况 权衡 。 

Zend Framework 的 执行 速度 在 新 的 Zend Framework 2 中 得 到 了 很 大 的 改善 ,相信 随 
着 信息 技术 的 发 展 、 服 务 器 及 网 络 传 输 性 能 的 不 断 提高 ,这些 问题 都 将 会 迎刃而解 。 

3) 学 习 资料 少 ,入 门 比 较 难 

Zend Framework 采用 纯正 的 OOP 技术 ,要 求学 习 者 具有 扎实 的 基础 理论 功底 ,这 使 
得 不 少 学 习 者 望 而 生 旦 。 另 外 ,Zend Framework 的 学 习 文 档 大 而 全 , 且 不 怎么 友好 ,显得 
太 理 论 化 ,难以 理解 ,与 实际 应 用 之 间 的 差距 较 大 。 尤 其 让 学 习 者 烦恼 的 是 ,关于 Zend 
Framework 的 中 文教 程 奇 缺 ,官方 给 出 的 中 文 手册 仅仅 是 一 个 简单 的 英汉 对 照 手册 ,不 符 
合 中 国人 的 学 习习 惯 。 这 些 都 使 学 习 者 学 习 Zend Framework 变 得 更 加 困难 。 
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基于 此 ,我 们 将 一 个 实际 的 Zend Framework 项 目 简 单 化 步骤 化 后 写成 了 本 书 ,希望 
给 大 家 的 学 习 提供 一 些 帮 助 。 


1.1.2 Zend Framework 的 常用 组 件 


作为 一 整套 PHP 开发 框架 的 解决 方案 ,Zend Framework 分 为 若干 个 组 成 部 分 。 每 个 
部 分 都 称 为 一 个 组 件 ,每 个 组 件 实现 特定 的 功能 。 按 照 功能 不 同 , 可 以 把 Zend Framework 
划分 为 以 下 5 个 组 成 部 分 。 

1. MVC 组件 

MVC 组 件 用 于 实现 MVC 开发 模式 的 各 个 部 分 ,包括 控制 器 .视图 等 ,其 中 的 Zend_ 
Controller 是 Zend Framework 架构 的 控制 核心 。 

2. 功能 组 件 

功能 组 件 作 为 Zend Framework 的 功能 核心 ,不仅 为 Zend Framework 框架 服务 ,还 适 
用 于 其 他 各 类 应 用 程序 ,可 以 为 应 用 程序 提供 功能 各 异 的 支持 ,包括 文件 与 类 的 动态 加 载 、 
配置 数据 的 使 用 .过 滤 与 校 验 .数据 缓存 .访问 控制 .邮件 操作 、 系 统 日 志 等 。 

3. 数据 操作 组 件 

数据 操作 组 件 用 于 数据 操作 ,其 中 包括 数据 库 操作 、 文 本 搜索 以 及 PDF 操作 等 。 文 本 
搜索 引擎 可 以 对 文件 系统 进行 操作 ,并 完成 相应 的 功能 ,例如 新 建文 件 夹 、 上 传 文件 等 。 

4. 服务 类 组 件 

服务 类 组 件 用 于 实现 各 类 服务 ,例如 RSS、XMIL-RPC、REST 等 。 

5. 国际 化 组 件 

国际 化 组 件 用 于 实现 应 用 程序 的 国际 化 功能 ,也 就 是 要 让 同样 的 应 用 程序 能 够 在 不 同 
的 地 方 使 用 。 这 里 需要 解决 的 问题 主要 有 语言 .日 期 与 时 间 、 货 币 ` 计 量 单位 以 及 数据 格 
式 等 。 

需要 强调 的 是 ,Zend Framework 一 方面 是 以 MVC 组 件 中 的 Zend. Controller 前 端 控 
制 器 为 中 心 的 软件 架构 产品 , 另 一 方面 也 是 数据 库 连 接 . 认 证 .过 滤器 等 各 种 功能 组 件 的 类 
库 。 这 些 功能 组 件 彼此 独立 ,都 能 以 单独 的 类 库 形式 被 使 用 。 例 如 ,在 不 需要 框架 的 项 目 
中 ,如 果 只 需要 使 用 数据 库 操 作 功 能 ,只 需要 将 Zend Framework 的 Zend_Db 组 件 类 库 导 入 
到 项 目 中 就 可 以 了 ,这 也 体现 了 Zend Framework 的 松 耦 合 性 设计 。 

Zend Framework 常用 组 件 及 其 功能 如 表 1. 1 所 示 。 

表 1.1 Zend Framework 常用 组 件 及 功能 


组 件 功 能 

Zend_Acl 实现 访问 控制 列表 功能 

Zend Auth 提供 认证 功能 

Zend_Cache 实现 数据 缓存 功能 

Zend_Config 配置 文件 管理 ,可 以 从 INI 或 者 XML 配置 文件 中 读 取 数 据 

Zend_Controller MVC 中 的 控制 器 部 分 ,为 应 用 程序 提供 全 面 的 控制 , 它 将 请 求 转化 为 特定 的 行为 
并 确保 其 执行 

Zend Currency 操作 货币 /数值 的 格式 


Zend_Date 实现 不 同 地 域 的 日 期 时 间 功 能 


续 表 


组 件 功 能 
Zend_Db 基于 PHP 数据 对 象 (PDO) ,并 提供 一 种 通用 的 方式 来 访问 数据 库 
Zend_Debug 提供 调试 功能 
Zend_Exception 实现 异常 处 理 功能 
Zend. Feed 提供 连接 RSS/ Atom Feed 的 手段 
Zend_Filter 提供 对 输入 字符 串 进 行 过 滤 的 方法 
Zend Form 制作 复杂 的 Form 表单 
Zend Http 控制 经 由 HTTP 协议 的 通信 
Zend_Json 实现 将 PHP 对 象 转换 成 JavaScript 对 象 符号 ,或 者 进行 反方 向 的 转换 


Zend_Loader 
Zend_Locale 
Zend_Log 
Zend_Mail 
Zend_Measure 
Zend_Memory 
Zend_Mime 
Zend_Pdf 
Zend_Rest 
Zend_Registry 
Zend_Search_Lucene 
Zend_Servic 
Zend Session 
Zend Translate 
Zend Uri 

Zend Validate 
Zend View 
Zend XmlRpc 


动态 加 载 文件 或 类 


其 他 国际 化 类 的 基 类 ,为 其 他 国际 化 类 提供 支持 


提供 通用 日 志 功能 
提供 邮件 收发 功能 


实现 不 同 地 域 计 量 单位 的 转换 

实现 在 限制 内 存 环境 下 的 操作 

用 于 为 Zend. Mail 组 件 解码 MIME 消息 
创建 新 的 PDF 文档 ,以 及 加 载 和 编辑 现 有 文档 


实现 REST 服务 


值 与 对 象 (全 局 变量 ) 的 存储 容器 
用 来 构建 基于 文本 的 全 文 搜索 引擎 
使 用 网 络 上 知名 服务 提供 商 的 API 


管理 ,操作 Session 数据 


翻译 组 件 , 可 以 通过 适配器 实现 不 同 语言 的 互 译 


用 于 对 URI 进行 操作 


实现 校 验 器 功能 ,判断 某 个 字符 串 是 否 符合 某 个 标准 
处 理 MVC 模式 的 “视图 ”部 分 
提供 连接 XML-RPC 式 服 务 的 手段 


1.2 搭建 开发 环境 


进行 Zend Framework 项 目 开发 ,首先 需要 搭建 相应 的 开发 环境 。 目 前 ,PHP 应 用 的 
开发 环境 普遍 采用 XAMP 的 平台 形式 。 所 谓 XAMP ,其 实 是 几 种 软件 的 组 合 , 其 中 的 X 是 
指 操作 系统 ,例如 L(Linux)、W(Windows)、M(Mac OS) 等 ,而 AM 和 了 分别 代 表 Apache 
网 络 服务 器 MySQL 数据 库 管 理 系 统 和 PHP( 或 者 Per 应 用 服务 器 。PHP、Apache 及 
MySQL 是 经 典 的 Web 应 用 开发 平台 。 

本 书 为 Zend Framework 项 目 开发 基础 入 门 教程 .考虑 到 大 多 数学 习 者 使 用 的 是 


Windows 操作 系统 ,所 以 采用 WAMP 的 开发 环境 配置 方案 。 
集成 软件 包 的 安装 与 配置 


zl 


在 Windows 操作 系统 中 分 别 安装 并 配置 Apache、MySQL 及 PHP 会 非常 复杂 ,这 里 使 


用 集成 软件 包 自动 完成 WAMP 开发 环境 的 搭建 。 
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目前 广泛 使 用 的 集成 软件 包 有 两 个 : 一 个 是 XAMPP, 另 一 个 是 AppServ。 下 面 对 这 两 
个 集成 软件 包 的 安装 与 配置 进行 简单 介绍 。 

1. XAMPP 软件 包 

XAMPP 是 一 个 功能 强大 的 PHP 开发 集成 软件 包 , 是 一 款 完全 免费 的 Apache 发 行 版 
本 ,包括 MySQL、PHP 和 Perl。 该 软件 包 原 来 的 名 字 叫 LAMPP, 为 了 避免 误解 ,最 新 的 几 
个 版 本 改名 为 XAMPP。 目 前 ,XAMPP 提供 4 种 不 同 的 版 本 ,可 以 分 别 在 Windows, 
Linux,Mac OS, Solaris 4 种 操作 系统 下 安装 使 用 ,支持 英文 .简体 中 文 、. 繁 体 中 文 、 韩 文 、 俄 
文 日 文 等 多 种 语言 。 其 官方 网 址 为 http://www. apachefriends. org ,提供 的 下 载 格式 有 可 
执行 文件 和 压缩 包 两 种 。 

本 书 所 用 的 Windows 操作 系统 为 Windows 7 旗舰 版 ,采用 的 XAMPP 软件 包 是 目前 
最 新 的 1. 8. 3 版 本 ,下 载 格式 为 可 执行 文件 形式 。 当 使 用 的 版 本 不 同时 ,安装 方法 文件 路 
径 等 可 能 会 有 不 同 ,请 大 家 注意 。 

XAMPP 集成 软件 包 的 下 载 与 安装 步骤 如 下 : 

CD 在 计算 机 上 创建 XAMPP 资源 文件 夹 , 例 如 E:\XAMPP。 

(2) 打开 浏览 器 ,在 地 址 栏 中 输入 http://www. apachefriends. org, 单 击 页 面 中 的 
XAMPP for Windows 链接 ,下 载 XAMPP 的 Windows 版 本 ,这 里 为 xampp-win32-1. 8. 3- 
4-VCll-installer. exe, 将 其 保存 在 E:\XAMPP 文件 夹 中 。 

G) 双击 下 载 的 XAMPP for Windows 安装 文件 ,启动 安装 程序 。 

如 果 是 Windows 7 操作 系统 ,会 连续 弹出 如 图 1. 1 所 示 的 两 个 提示 框 ,直接 单 击 Yes 
和 OK 按钮 进入 下 一 步 。 


It seems you have an antivirus running. In some cases, this may slow 
down or interfere the installation of the software. Please visit the 
following link to learn more about this. 


http;//cms.apachefriends.org/en/faq-xampp-windows.htmifantivirus 


Continue with installation? 


C) ae. 


Important! Because an activated User Account Control (UAC) on your 
sytem some functions of XAMPP are possibly restricted. With UAC please 
avoid to install XAMPP to C:\Program Files (missing write permissions). 
Or deactivate UAC with msconfig after this setup. 

1.1 安装 提示 对 话 框 


(4) 在 接 下 来 的 对 话 框 中 连续 单 击 Next 按钮 ,直到 弹出 如 图 1. 2 所 示 的 正式 安装 界面 。 

(5) 单 击 图 1. 2 所 示 对 话 框 中 的 Next 按钮 ,打开 如 图 1. 3 所 示 的 界面 。 

这 一 步 选择 需要 安装 的 组 件 , 请 务必 择 选 Apache、MySQL 两 个 组 件 , 用 于 安装 Apache 
Web 服务 器 以 及 MySQL 数据 库 服务 器 ,建议 选择 phpMyAdmin 数据 库 管 理工 具 , 以 方便 


Welcome to the XAMPP Setup Wizard. 


(S) bitnami 


(Bak ] (Came | 


1.2 安装 主页 面 对 话 框 


后 续 对 数据 库 的 各 种 可 视 化 操作 。 
单 击 Next 按钮 进入 下 一 步 ,如 图 1.4 所 示 。 


Select the components you want to install clear the components you do not want to install. Cick Next. 
when you are ready to continue. 


Click on a component to get a detailed description. 


图 1.3 选择 组 件 对 话 框 

(6) 在 图 1.4 所 示 的 对 话 框 中 选择 XAMPP 软件 包 的 安装 路 径 , 单 击 Next 按钮 开始 
安装 。 

CD 在 安装 完成 对 话 框 中 ,如 果 选 择 了 Do you want to start the Control Panel now? 
复 选 框 , 单 击 Finish 按钮 会 打开 XAMPP 的 控制 面板 ,如 图 1. 5 所 示 。 

单 击 图 1.5 所 示 的 KAMPP 控制 面板 中 各 组 件 对 应 的 Actions 按钮 ,可 以 对 相应 服务 
器 进行 开启 与 关闭 控制 。 注 意 开启 某 项 服务 时 控制 面板 下 部 给 出 的 详细 信息 ,如 果 出 现 红 
色 错 误 提 示 , 则 需要 进行 相应 的 处 理 。 


Zend Framework 开发 环境 


PHP Zend Framework 5t A FEŻ 2 RUHE 


Cur MEE E 


Installation folder e] 
Please, choose a folder to install XAMPP 
Select a folder Campp A 

XAMPP Installer 


图 1.4 选择 安装 目录 


XAMPP Control Panel v3.2.1 
PID(s) Ports) Actions 


( Admin ] 


[Set j 


Admin 


_ Siar | 


Admin ] 


[ Admin | 


Sn | 


[ Admin ] 


XANPP Version: 1.8.3 


Checking for prerequisites 
All prerequisites found 
Initializing Modules 
2 Starting Check-Timer 
:42 [main] Control Panel Ready 


Control Panel Version: 3.2.1 [ Compiled: May Tth 2013 ] 
Running vith Administrator rights — good! 
XAMPP Installation Directory: “d:\xanpp\” 


1.5 XAMPP 控制 面板 


(8) 安装 测试 。 


软件 包 安 装 完成 ,并 成 功 启动 Apache Web 服务 器 后 ,在 浏览 器 地 址 栏 中 输入 http:// 
localhost ,或 者 在 XAMPP 控制 面板 中 单 击 Apache 对 应 的 Admin 按钮 。 如 果 能 看 到 如 
图 1.6 所 示 的 页 面 , 则 表明 XAMPP 安装 成 功 ,可 以 使 用 了 。 


(9) 设置 MySQL 数据 库 服务 器 密码 。 


在 上 述 安装 过 程 中 ,安装 程序 没有 提示 输入 数据 库 登 录 的 用 户 名 和 密码 ,默认 用 户 名 为 
root、 密 码 为 空 。 为 了 安全 起 见 , 最 好 为 数据 库 设置 一 个 安全 密码 。 

在 如 图 1.6 所 示 的 页 面 左 侧 导 航 栏 中 找到 security 链接 , 单 击 该 链接 ,打开 如 图 1.7 所 
示 的 页 面 。 然 后 单 击 页 面 中 的 http://localhost/security/xamppsecurity. php 链接 ,为 数据 


库 设置 登录 用 户 名 与 密码 。 
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[2] XAMPP for Windows 


Welcome to XAMPP for Windowst 


Enghsh / Deutsch / Francais / Rededende / Polais / Rain， Norwegian Español = / Portuguès (Brasil)/ E2% 


Yon have successfully installed XAMPP on this system! 

Now you can start using Apache and Co. You shouid frst try éstatus on the left navigation to make sure everything works ine. 
For OpensSL support please use the test cercate weh os://127.0.1 or bezps://iocaihost 

Good uk kay ogelgesang + Kai Oswald Seer 

Install applications on XAMPP using BitNami 


Apache Friends. are cooperating to make dozens of open source applications available on XAMPP, for free. BitNami-packaged applications include Wordpress, 
Dupa, koomil and dozens af eere and Ci be deployed WEN cna cit atas V Vh etam KANPE ode fo dette one durent avataDie apps" 
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图 1.6 XAMPP 软件 包 主 页 面 
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[3] XAMPP for Windows 
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PhpMyAdmin password login is enabled. 

A FTP server is not running or is blocked by a firewall! 
marked points are secure; the red marked points are definitively unsecure and the yellow marked points couldnt be checked (for example because the. 
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图 1.7 设置 数据 登录 用 户 名 与 密码 页 面 


(10) 验证 phpMyAdmin 是 否 安装 成 功 。 

在 XAMPP 控制 面板 中 启动 Apache 与 MySQL 服务 器 , 单 击 MySQL 对 应 的 Admin 
按钮 ; 或 单 击 图 1.6 所 示 的 页 面 中 、 左 侧 导 航 栏 中 的 phpMyAdmin 链接 ,打开 如 图 1. 8 所 
示 的 phpMyAdmin 数据 库 管 理 器 主页 面 。 

在 页 面 中 输入 用 户 名 和 密码 , 即 可 进入 如 图 1. 9 所 示 的 数据 库 管 理 界 面 。 在 这 里 可 以 
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1.8 phpMyAdmin 数据 库 管 理 器 主页 面 


进行 MySQL 数据 库 的 所 有 可 视 化 操作 ,对 于 不 太 熟 悉数 据 库 命令 方式 的 开发 者 来 说 , 它 是 
一 个 得 力 的 好 助手 。 
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1.9 phpMyAdmin 数据 库 管 理 器 界面 


至 此 ,XAMPP 软件 包 安 装 完毕 。 这 时 ,在 计算 机 系统 中 就 搭建 起 了 一 个 名 为 WAMP 
的 PHP 应 用 开发 平台 。 

图 1. 10 所 示 为 XAMPP 软件 包 的 安装 目录 ,在 安装 目录 下 可 以 看 到 选择 的 各 种 软件 的 
安装 文件 夹 。 在 根 目 录 下 有 一 个 名 为 htdocs 的 文件 夹 , 它 是 存放 PHP 脚本 的 目录 ,也 是 项 
目 开发 时 源 文件 存 人 的 位 置 。 对 于 这 些 目 录 请 大 家 重点 关注 ,在 以 后 的 项 目 开发 过 程 中 对 
配置 文件 ,数据 库 文件 以 及 项 目 文件 的 各 种 操作 都 是 在 这 些 文件 夹 中 进行 的 。 


po» 计算 机 > SERR (D) » xampp ， 


MercuryMail mysal 


xampp_start.exe 收 改 日 期 : 2013/3/30 19:29 创建 日 期 : 2014/5/27 9:56 
应 用 程序 大 小 116 KB 


1.10 XAMPP 软件 包 的 安装 目录 


2. AppServ 软件 包 

AppServ 也 是 一 个 目前 比较 流行 的 软件 工具 包 , 可 以 为 用 户 快速 搭建 PHP 的 应 用 开发 
环境 。 它 包括 Apache Web 服务 器 .PHP 应 用 服务 器 、MySQL 数据 库 管 理 系统 和 phpMyAdmin 
数据 库 管 理工 具 4 个 部 分 。 

AppServ 软件 包 的 官方 网 址 为 http://www. appservnetwork. com, 目 前 的 最 新 版 本 为 2. 6。 

下 面 简单 介绍 AppServ 软件 包 的 安装 步骤 : 

CD 打开 浏览 器 ,在 地 址 栏 中 输入 上 述 官方 网 址 ,进入 AppServ 官方 网 站 ,下 载 AppServ 
安装 软件 ,这 里 以 2013-10-25_appserv-win32-2. 6. 0. 13413644756. exe 为 例 进行 示范 。 

(2) 双击 运行 下 载 的 AppServ 安装 软件 启动 安装 程序 ,如 图 1. 11 Bros ,然后 单 击 Next 
按钮 进入 下 一 步 。 


Welcome to the AppServ 2.6.0 
Setup Wizard 


This wizard wil guide you through the installation of AppServ 
26.0. 


Itis recommended that you dose all other applications. 
before starting Setup. This wil make it possible to update 
relevant system fles without having to reboot your. 
computer. 


Ck Next to continue. 


AppServsOpen Projectis 
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1.11 AppServ 软件 包 的 安装 对 话 框 


Zend Framework 开发 环境 


PHP Zend Framework 7i A FÈ X sb € f] 38 


(3) 在 是 否 同意 协议 的 界面 中 单 击 I Agree 按钮 ,进入 安装 目录 设置 界面 ,如 图 1. 12 
所 示 。 


Choose Install Location 
Choose the folder in which to install AppServ 2.6.0. 


wil install AppServ 2.6.0 in the following folder. To install in a different folder, dick 
Browse and select another folder. Click Next to continue. 


Space required: 77.5MB 
Space available: 31.5GB. 


Nullsoft Install System v2,18 一 


图 1.12 安装 目录 设置 
OD 选择 安装 路 径 后 单 击 Next 按钮 进入 组 件 选择 界面 ,如 图 1. 13 所 示 。 


Select the components you want to install, dear the components 
you do not want to install 


Nullsoft Install System v2.18 


1.13 组 件 选择 对 话 框 


(5) 选择 界面 中 的 全 部 组 件 , 单 击 Next 按钮 ,进入 服务 器 信息 设置 界面 ,如 图 1. 14 
所 示 。 

(6) 填写 HTTP 服务 器 的 地 址 , 即 127. 0. 0. 1 ,邮箱 地 址 可 以 随便 写 , 保 持 端口 号 为 
80 ,然后 单 击 Next 按钮 ,进入 MySQL 数据 库 设 置 界面 ,如 图 1. 15 所 示 。 

(7) 配置 MySQL 服务 器 的 root 用 户 密码 ,保持 字符 集 为 UTF-8 ,选择 Enable InnoDB 
复 选 框 , 单 击 Install 按钮 开始 安装 。 

(8) 软件 包 安 装 完成 ,选择 并 启动 Apache 和 MySQL 服务 器 后 ,在 浏览 器 中 输入 
http://localhost, 如 果 出 现 如 图 1. 16 所 示 的 页 面 , 则 表示 AppServ 软件 包 安 装 成 功 。 


Apache HTTP Server Information 
Please enter your server's information. 


Server Name (e.g. www.appservnetwork.com) 
l | 
Administrator's Email Address (e.g. webmaster Ggmal.com) 


1 


Apache HTTP Port (Default : 80) 
80 


Nullsoft Install System. 


Nullsoft Install System v2.18 


Æ 1.15 MySQL 数据 库 设置 界面 
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The AppServ Open Project - 2.6.0 for Windows 


JR phpMyAdmin Database Manager Version 2.10.3 
È) PHP Information Version 6 0.0-dev 


AppServis a merging open source software installer package for Windows nciudes 


» Apache Web Server Version 2.2.0 


* phpMyAdmin Database Manager Version 2.10.3 


* Changelog 
* README 
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Change Language : BS S3 
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1.16 AppServ 软件 包 主页 面 
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打开 AppServ 软件 包 的 安装 目录 ,可 以 看 到 我 们 所 选择 的 4 个 组 件 的 文件 夹 。 安 装 目 
录 中 的 www 目录 是 项 目 脚本 的 存放 目录 。 本 书 案例 项 目 采用 XAMPP 开发 环境 ,关于 
AppServ 集成 开发 环境 的 使 用 与 配置 ,请 大 家 查询 其 他 的 技术 资料 。 


1.2.2 设置 虚拟 主机 


XAMPP 集成 软件 包 安装 成 功 后 ,就 在 计算 机 中 搭建 了 WAMP 的 开发 平台 ,这 样 就 可 
以 进行 一 般 的 PHP 应 用 开发 了 .但 要 开发 基于 Zend Framework 框架 的 应 用 程序 ,还 必须 
设置 一 台 虚 拟 主机 来 模仿 真实 的 服务 器 环境 。 

为 什么 要 设置 虚拟 主机 才能 运行 Zend Framework 项 目 呢 ? 这 是 由 Zend Framework 
框架 的 路 由 规则 决定 的 。 关 于 这 一 点 将 在 下 一 章 详 细 介绍 ,这 里 大 家 先 掌 握 配置 虚拟 主机 
的 方法 。 

假设 开发 的 项 目 名 称 为 wmProject, 存 放 在 XAMPPNhtdocs 目录 中 , 即 Web 服务 器 的 
脚本 目录 中 。 对 于 一 般 的 PHP 应 用 程序 ,这 个 目录 就 是 项 目的 根 目录 ,首页 文件 index. php 
就 应 该 存放 在 这 里 。 但 由 于 Zend Framework 是 一 个 框架 ,具有 特定 的 目录 结构 , 它 的 首页 
文件 index. php 是 存放 在 项 目 文件 夹 的 public 目录 下 的 ,所 以 虚拟 主机 要 直接 指向 
XAMPPhtdocsWwmProjectNpublic 目录 。 

1. 添加 本 地 系统 DNS 

成 功 安装 XAMPP 后 的 计算 机 系统 就 已 经 是 一 台 本 地 服务 器 了 ,通过 在 浏览 器 的 地 址 
栏 中 输入 http://localhost 可 以 访问 存放 在 XAMPP\htdocs 目录 中 的 应 用 程序 ,例如 网 站 、 
办 公 系 统 等 ,也 就 是 说 ,通过 localhost 这 个 域名 就 可 以 访问 服务 器 的 根 目录 htdocs。 通 过 
修改 系统 配置 文件 可 以 为 本 机 设置 其 他 域名 ,例如 wmoams. com。 

CD 打开 系统 目录 C:\Windows\System32\drivers\etc, 用 文本 编辑 工具 打开 配置 文 
fF. hosts. HE EB: 


# Copyright (c) 1993 - 2009 Microsoft Corp. 


# 
# For example: 
# 
# 102.54.94.97 rhino. acme. com # source server 
# 38.25.63.10 x. acme. com # x client host 
# localhost name resolution is handled within DNS itself. 
127.0.0.1 localhost 
# kl localhost 
# 127.0.0.1 activate. adobe. com 


从 代码 中 可 以 看 到 localhost 对 应 本 机 IP 地 址 127. 0. 0.1, 所 以 在 浏览 器 的 地 址 栏 中 
输入 http://localhost 或 http://127.0.0.1 都 可 以 访问 服务 器 的 htdocs 根 目 录 。 
(2) 在 系统 配置 文件 . hosts 的 末尾 添加 如 下 代码 ,为 本 机 添加 新 域名 wmoams. com, 


127.0.0.1  wmoams.com 


保存 后 关闭 . hosts 配置 文件 ,在 XAMPP 控制 面板 中 重启 Apache 服务 器 。 在 浏览 器 


的 地 址 栏 中 输入 http://wmoams. com, 如 果 能 打开 如 图 1. 6 所 示 的 XAMPP 集成 开发 环境 
的 主页 面 , 则 说 明 域名 配置 成 功 。 

2. 开启 Apache 的 Rewrite 功能 

打开 如 图 1. 5 所 示 的 XAMPP 控制 面板 , 单 击 Apache 对 应 的 Config 按钮 ,打开 配置 文 
件 httpd. conf。 该 配置 文件 位 于 D:\xampp\apache\conf 目录 下 ,当然 也 可 以 在 文件 夹 下 直 
接 打 开 文 件 。 在 文件 中 找到 如 下 代码 : 

# LoadModule reqtimeout module modules/mod reqtimeout.so 

LoadModule rewrite module modules/mod rewrite. so 

# LoadModule sed module modules/mod sed. so 

确保 LoadModule rewrite module 前 的 井 注释 符号 是 去 除 的 ,这 样 就 开启 了 Apache 服 
务 器 的 Rewrite 功能 ,可 以 对 来 自 HTTP 的 请 求 进行 重 定 向 处 理 。 

这 里 XAMPP 已 经 进行 了 配置 。 不 同 的 XAMPP 版 本 ,初始 配置 不 尽 相同 ,当然 ,不 同 
的 Apache 的 安装 方式 更 是 有 不 同 的 配置 方法 ,请 大 家 特别 注意 这 一 点 。 

3. 添加 虚拟 主机 

(1) 打开 配置 文件 D:\xampp\apache\conf\httpd. conf ,找到 如 下 代码 : 


# Virtual hosts 
Include conf/extra/httpd - vhosts. conf 


确保 上 述 代码 中 Include 前 面 的 # 注 释 符号 是 去 除 的 ,这 名 代码 的 意思 是 启用 Apache 
服务 器 的 虚拟 主机 配置 文件 httpd-vhosts. conf, 

(2) 打开 Apache 服务 器 配置 文件 D:\xampp\apache\conf\extra\httpd-vhosts. cof, dE 
到 如 下 代码 ; 

# Use name - based virtual hosting. 

# 


NameVirtualHost * :80 
# 


确保 代码 中 的 NameVirtualHost 前 面 的 # 注 释 符号 是 去 除 的 。 代 码 前 的 注释 ,表明 将 
采用 重新 定义 名 称 的 方式 设置 虚拟 主机 。 除 了 重 命名 的 方式 以 外 ,用 户 还 可 以 采用 重新 设 
置 端口 的 方式 进行 虚拟 主机 的 设置 。 

(3) 在 Apache 服务 器 配置 文件 httpd-vhosts. cof 后 添加 如 下 代码 : 


<VirtualHost * :80> 
DocumentRoot "D: /xampp/htdocs" 
ServerName localhost 
</VirtualHost > 


<VirtualHost * :80> 
DocumentRoot "D: /xampp/htdocs/wnProject/public" 
ServerName wnoams. com 

</VirtualHost > 


这 段 代 码 分 为 两 个 单元 ,下 面 的 单元 是 新 设置 的 名 为 wmoams. com 的 虚拟 主机 , 根 目 
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录 是 D:\xampp\htdocs\wmProject\public, 也 就 是 项 目 wmProject 的 根 目录 ; 上 面 的 单元 
用 于 确保 原来 的 localhost 域名 不 会 失效 。 

(4) 测试 虚拟 主机 是 否 配 置 成 功 。 

打开 项 目的 D:\xampp\htdocs\wmProject\public 文件 夹 , 用 记事 本 新 建 一 个 index. php X 
件 , 代 码 如 下 : 


<?php echo "http://www. wmstudio. net.cn —-—---— Zend Framework project! "; 


重新 启动 Apache 服务 器 ,在 浏览 器 地 址 栏 中 输入 http: //wmoams. com, 如果 能 看 到 
如 图 1. 17 所 示 的 页 面 ,说 明 虚 拟 主机 设置 成 功 。 


{Æ http//wmoams.com/ - Windows Internet Explorer Eam) 
GO [0-6 rpymmoamscom 8 -|Blolxllsw P7 


XUHD RAO FEV HERA IAD WMH 
Aak |y sgg v panene p) aze 
[hup mmoemsco | | A- B - C & - mor s207 IAQ- 四 -” 


http://www.wmstudio.net.cn ------ Zend Framework project! 


E] @ Internet | 保护 模式 : 3 fà * Rioo% - 


1.17 虚拟 主机 测试 页 面 


1.2.3 开发 环境 的 配置 


上 面 通过 XAMPP 集成 软件 包 搭建 起 了 经 典 的 WAMP 开发 环境 ,并 且 发 现 许 多 配置 
已 经 设置 完成 。 这 表明 在 系统 安装 过 程 中 ,安装 程序 会 自动 进行 一 些 基础 配置 ,这 也 正 是 我 
们 选择 集成 软件 包 创建 开发 环境 的 原因 。 

下 面 以 作者 计算 机 中 的 软件 安装 目录 为 例 ,简单 介绍 WAMP 开发 环境 配置 过 程 中 涉 
及 的 一 些 配 置 文件 。 

1. Windows 系统 配置 文件 

Windows 配置 文件 有 很 多 ,这 里 我 们 用 到 的 只 有 hosts 文件 , 它 位 于 C:\Windows\ 
System32\drivers\etc 目录 下 ,主要 用 来 设置 本 机 服务 器 的 新 域名 。 

2. PHP 配置 文件 

1) 使 用 PHP 扩展 库 

PHP 配置 文件 php. ini 位 于 PHP 安装 根 目录 下 ,在 这 里 大 家 可 以 发 现 多 个 INT 配置 
文件 ,例如 php. ini-development、php. ini-production 等 ,它们 是 PHP 开发 者 为 用 户 准 备 的 
配置 文件 模板 ,大 家 应 根据 项 目 开 发 的 不 同 阶段 选用 不 同 的 配置 模板 文件 。 

打开 目录 中 的 php. ini 配置 文件 ,可 以 发 现 文 件 里 有 各 种 各 样 的 配置 选项 ,要 全 部 弄 清 


每 项 配置 的 含义 不 是 一 件 容易 的 事情 ,请 大 家 特别 关注 文件 中 如 下 形式 的 代码 : 


extension = php bz2.dll 
extension = php curl.dll 
extension = php mbstring.dll 
extension = php exif.dll 
;extension- php fileinfo.dll 
extension = php gd2.dll 
extension = php gettext.dll 
;extension- php gmp.dll 
;extension- php intl.dll 
;extension- php imap.dll 
;extension- php interbase.dll 
;extension- php ldap.dll 
extension = php mssql.dll 
extension = php mbstring.dll 


以 上 是 启用 PHP 扩展 库 的 代码 ,去掉 extension 前 面 的 “;? 注 释 符号 ,表示 加 载 了 相应 
的 PHP 扩 展 库 。PHP 库 文件 存放 在 PHP 根 目录 的 pear 文件 夹 下 ,动态 链接 库 的 *. dll 
文件 存放 在 PHP 根 目 录 下 。 在 上 面 的 代码 中 去 掉 了 注释 符号 的 语句 , 它 是 在 安装 KAMPP 
过 程 中 系统 自动 配置 的 。 

2) 默认 时 区 设置 

打开 PHP. ini 配置 文件 ,找到 如 下 代码 ,将 默认 时 区 设置 为 PRC。 

[Date] 

; Defines the default timezone used by the date functions 

; http: //php. net/date. timezone 

;date. timezone = Europe/Berlin 

date. timezone = PRC 

3) 默认 字符 集 设置 

打开 PHP. ini 配置 文件 ,找到 如 下 代码 ,将 默认 字符 集 设 置 为 utf-8。 

; PHP's default character set is set to empty. 

; http: //php. net/default - charset 

default_charset = "utf - 8" 

3. Apache 服务 器 配置 文件 

Apache 服务 器 配置 文件 有 标准 配置 与 扩展 配置 两 种 类 型 。 

1) Apache 标准 配置 文件 httpd. conf 

该 文件 位 于 D:\xampp\apache\conf 目录 下 ,主要 完成 一 些 服 务 器 的 基础 配置 工作 。 

2) Apache 扩展 配置 文件 

在 Apache 服务 器 的 D:\xampp\apache\conf\extr 目录 下 有 很 多 配置 文件 ,这 些 都 是 
Apache 的 扩展 配置 文件 ,例如 上 面 用 到 的 httpd-vhosts. conf 文件 。 启 用 这 些 配置 文件 需 
要 打开 httpd. conf 中 相应 的 include 语句 ,在 上 面 设置 虚拟 主机 的 过 程 中 ,我 们 就 打开 了 
httpd. conf 中 的 语句 : 


H- 


Zend Framework P IRI 


PHP Zend Framework 7i A 7F X X H fe] 368 


Include conf/extra/httpd — vhosts. conf 


4. MySQL 数据 库 配 置 文件 
MySQL 数据 库 配置 文件 my-default. ini 位 于 D:\xamppN\mysql 目录 下 ,主要 用 于 完成 
MySQL 数据 库 管理 系统 的 配置 工作 。 


1.2.4 Zend Framework 的 安装 


上 面 已 经 成 功 搭建 并 配置 了 WAMP 的 PHP 应 用 程序 开发 环境 ,如 果 要 运行 Zend 
Framework 项 目 , 还 需要 安装 Zend Framework。 

Zend Framework 的 官方 下 载 地 址 为 http://www. zend. com, 下载 后 的 Zend 
Framework 是 一 个 压缩 包 。 将 压缩 包 解压 ,可 以 看 到 里 面 有 各 种 各 样 的 文件 夹 及 文件 ,但 
并 没有 常见 的 可 执行 安装 程序 。 

前 面 介绍 了 Zend Framework 的 结构 及 常用 组 件 的 功能 ,这 些 组 件 其 实 就 是 一 些 类 库 。 
所 以 ,所 谓 Zend Framework 安装 实质 上 是 让 PHP 能 访问 Zend Framework 的 库 文件 。 

D 查看 PHP 的 include_path 路 径 

打开 XAMPP 的 控制 面板 ,启动 Apache 服务 器 ,在 浏览 器 的 地 址 栏 中 输入 http:// 
localhost ,打开 如 图 1. 6 所 示 的 页 面 。 单 击 页 面 左 侧 导 航 栏 中 的 phpinfo() 链 接 ,打开 
phpinfo 信息 页 面 ,找到 include path 显示 项 ,如 图 1. 18 所 示 。 


Æ 1.18 phpinfo 信息 页 面 


从 图 1. 18 中 可 以 看 出 ,PHP 的 include path 路 径 为 D:\xampp\php\PEAR。 将 Zend 
Framework 解压 后 的 library\Zend 文件 夹 复制 到 该 路 径 下 , Zend Framework 就 安装 完 
RT. 

2) 测试 Zend Framework 

如 果 要 测试 Zend Framework 能 否 正常 工作 ,最 简单 的 方法 就 是 直接 引用 (不 带路 径 ) 


Zend Framework 组 件 , 如 果 程 序 不 报错 就 说 明 Zend Framework 安装 成 功 。 
在 上 面 创建 的 项 目 wmProject 的 public 目录 下 新 建文 件 date. php 并 添加 如 下 代码 : 
<?php 
require once( 'Zend/Date. php') ; 
$date = new Zend Date(); 
echo Date('Y - m- d', $date- » get()); 
?> 
在 浏览 器 的 地 址 栏 中 输入 http://wmoams. com/date. php ,如 果 能 看 到 如 图 1. 19 所 示 
的 页 面 效 果 , 则 说 明 Zend Framework 成 功 安装 。 


[TÆ resi] moams.com/date php - Windows Internet Explorer IT 
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2015-06-07 
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完成 @ Internet | 保护 模式 : 禁用 fà * *$1096 ~ | 
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1.19 Zend Framework 安装 测试 


1.3 开发 工具 与 技术 文档 


上 面 创 建 的 WAMP 开发 环境 只 是 PHP 应 用 程序 的 调试 与 运行 环境 ,如 果 要 进行 项 目 
的 开发 ,还 需要 一 些 PHP 脚本 查看 与 编辑 工具 。 另 外 ,在 PHP 项 目的 开发 过 程 中 需要 编 
写 一 些 HTML 网 页 文件 .CSS 样式 文件 以 及 JavaScript 脚本 文件 ,同样 需要 用 相应 的 开发 
工具 来 完成 。 下 面 介绍 两 款 常用 的 PHP 应 用 开发 工具 。 


1.3.1 Zend Studio 集成 开发 环境 


Zend Studio 是 Zend Technologies 公司 开发 的 PHP 语言 集成 开发 环境 ,具备 功能 强大 
的 专业 编辑 工具 和 调试 工具 ,支持 PHP 语法 高 亮 显 示 , 并 有 智能 语法 提示 功能 ,可 以 大 大 
提高 开发 效率 。 另 外 , 它 还 支持 语法 自动 填充 .语法 自动 缩 排 \ 代 码 复制 和 书签 等 功能 。 

Zend Studio 集成 开发 环境 内 置 的 调试 工具 功能 强大 ,支持 本 地 和 远程 两 种 调试 模式 ， 
并 支持 多 种 高 级 调试 功能 ,例如 跟踪 变量 、 单 步 运行 、 断 点 、 堆 栈 信息 、 函 数 调用 、 查 看 实时 输 
出 等 。 此 外 , 它 对 中 文 也 有 非常 好 的 支持 。 

Zend Studio 包含 了 PHP 应 用 开发 所 有 必需 的 部 件 , 通 过 一 整套 编辑 、 调 试 、 分 析 、 优 化 
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和 数据 库 工具 极 大 地 缩短 了 开发 周期 ,并 简化 了 复杂 的 应 用 方案 。 考 庸 置疑 , 它 已 经 是 目前 
最 强大 的 PHP 集成 开发 环境 ,当然 也 是 Zend Framework 项 目 开 发 的 首选 。 

Zend Studio 集成 开发 环境 的 官方 下 载 地 址 为 http://www. zend. com, 能 提供 多 种 版 
本 的 下 载 。Zend Studio IDE 是 一 款 收 费 软件 ,试用 版 本 有 30 天 的 试用 期 。 本 书 作者 使 用 
的 是 目前 比较 新 的 10.6 版 。 

Zend Studio 的 Windows 版 本 是 一 个 以 . msi 为 扩展 名 的 程序 包 , 双 击 打 开 即 可 安装 。 
安装 成 功 后 打开 软件 ,界面 如 图 1. 20 所 示 。 下 面 简 单 介绍 Zend Studio 的 功能 及 使 用 中 需 
要 注意 的 一 些 问 题 。 
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Æ 1.20 Zend Studio 集成 开发 环境 界面 


1. 工作 台 的 切换 

Zend Studio IDE 是 一 个 功能 强大 的 开发 环境 , 它 不 仅 可 以 编辑 .调试 PHP. 代码 ,还 可 
以 编辑 .调试 其 他 类 型 的 文件 。 如 图 1. 30 所 示 的 界面 为 PHP 项 目 工作 界面 ,这 也 是 它 的 默 
认 工 作 台 界面 。 

选择 菜单 栏 中 的 Window|Open Perspective 菜单 项 ,或 者 单 击 如 图 1. 21 所 示 的 界面 右 
上 和 角 的 工作 台 切 换 图 标 ,都 可 以 对 工作 台 进 行 切换 。 

2. 工作 区 的 切换 

与 其 他 集成 开发 环境 一 样 ,例如 Visual Studio, Eclipse, myEclipse 等 ,Zend Studio 对 项 
目的 管理 也 是 以 工作 区 的 形式 进行 的 。 如 图 1. 20 所 示 ,界面 左 侧 区 域 即 Zend Studio 的 项 
目 工 作 区 ,在 这 里 显示 当前 工作 区 中 的 所 有 项 目 。 有 时 我 们 会 将 不 同类 型 的 应 用 项 目 放 在 
不 同 的 工作 区 中 ,这 样 就 需要 进行 工作 区 的 切换 。 

Zend Studio 工作 区 的 选择 有 两 种 方法 ,一 是 在 启动 Zend Studio 时 对 工作 区 进行 选择 ， 
另外 就 是 在 Zend Studio 打开 以 后 进行 切换 。Zend Studio 启动 后 工作 区 的 切换 是 通过 选择 
File| Switch Workspace 菜单 项 实现 的 。 
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图 1.21 Zend Studio 工作 台 的 切换 


3. 工作 区 属性 设置 
工作 区 属性 设置 后 ,对 本 工作 区 中 的 每 一 个 项 目 都 是 有 效 的 。 选 择 Window | Perferences 
菜单 项 ,打开 属性 设置 对 话 框 , 如 图 1. 22 所 示 。 


E Always run in background 
El Keep next/previous editor, view and perspectives dialog open 
El Show heap status 
Open mode 
@ Double click 
Single click 
[Select on hover 
[Open when using arrow keys 
Note: This preference may not take effect on all views. 


图 1.22 Zend Studio 工作 区 属性 设置 


4. 项 目 属性 设置 
在 工作 区 中 选择 某 个 项 目 , 选 择 Project| Perferences 菜单 项 ,打开 项 目 属性 设置 对 话 
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框 ,如 图 1.23 所 示 。 注 意 ,在 这 里 设置 的 属性 只 对 本 项 目 有 效 。 
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PHP Interpreter © Other: [GBK S 
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Save Actions 

n |Windows ~ 
Soman bsis | O Other [Windows -] 
Task Tags 
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图 1.23 Zend Studio 项 目 属性 设置 


5. 查看 源 代 码 

在 Zend Studio 集成 开发 环境 的 代码 编辑 区 用 鼠标 指向 某 一 个 类 ,就 可 以 在 提示 框 中 
查看 该 类 的 一 些 基本 信息 。 如 果 要 查看 源 代 码 , 单 击 提示 框 的 跳 转 图 标 即 可 ,如 图 1. 24 所 
示 。 在 该 图 中 用 鼠标 指向 类 Zend_Form, 就 会 出 现 Zend. Form 类 的 基本 信息 , 单 击 下 面 的 
显示 图 标 , 就 可 以 在 该 编辑 区 中 打开 Zend. Form 类 的 源 文件 ,这 对 项 目 开发 是 非常 有 好 处 的 。 


$this-»sethame(* p 


Dettethod( post) ato. 
->addhttribs(array( 
"style" 


Suserhame-»setLabel( F 

$userName->setRequired (TRUE); 
$userName-saddValidator("stringLength', false, array(S, 20)); 
Suserlane-»addtrrorMessage('* RPRETAXS-04$082-6H22'); 
Sthis-»addtlenent ($userName); 


// En 

Spassword = $this-»createtlement('password', 'password'); 
$password-»setLabel('ER: '); 
Spassword-»setRequired(TRUE); 
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1.24 Zend Studio 编辑 区 


6. 查看 类 的 变量 及 方法 

面向 对 象 的 编程 主要 是 类 的 设计 与 方法 的 使 用 。 对 于 初学 者 而 言 , 最 大 的 困难 在 于 不 
知道 类 中 到 底 有 些 什 么 样 的 方法 ,也 不 清楚 方法 的 访问 权限 及 调用 后 返回 的 数据 类 型 。 在 
Zend Studio 集成 开发 环境 中 可 以 很 轻松 地 解决 这 些 问题 。 

如 上 所 述 , 当 打开 Zend_Form 类 以 后 ,在 Zend Studio 的 Outline 窗口 中 就 会 显示 该 类 
的 属性 与 方法 ,如 图 1. 25 所 示 。 单 击 Outline 窗口 中 的 某 个 方法 ,就 可 以 在 编辑 区 中 打开 
该 方法 的 源 文件 。 
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Æ 1.25 Zend Studio 中 类 信息 的 显示 


7. 文件 的 复制 与 删除 

Zend Studio 中 对 文件 的 更 名 、 复 制 与 删除 操作 可 以 在 项 目 工作 区 中 直接 进行 。 例 如 ， 
要 把 一 个 图 片 文件 复制 到 项 目 中 的 images 文件 夹 ,就 可 以 先 将 该 文件 复制 到 剪 切 板 上 , 然 
后 直接 单 击 工作 区 项 目 中 的 images 文件 夹 ,右键 粘贴 。 如 果 要 删除 项 目 中 的 某 个 文件 或 文 
件 夹 ,只 要 选中 后 右键 删除 ,或 选中 后 用 键盘 上 的 Delete 键 删除 即 可 。 需 要 特别 提醒 的 是 ， 
这 里 的 删除 操作 是 直接 从 硬盘 上 删除 ,不 会 放 入 回收 站 中 ,也 没有 倒退 键 撤销 该 操作 ,这 一 
点 请 大 家 务必 注意 。 

8. 常用 快捷 键 

采用 快捷 方式 进行 操作 能 大 大 地 提高 开发 效率 。 菜 单项 的 快捷 方式 可 以 在 菜单 栏 中 查 
看 到 ,也 可 以 通过 组 合 键 Ctrl 十 Shift 十 L 查询 ,如 图 1. 26 所 示 。 注 意 ,不 同 版 本 的 Zend 
Studio 的 快捷 方式 可 能 会 有 些 差异 。 


1.3.2 Nodepad++ 代 码 编辑 器 


Notepad++ 是 一 款 Windows 环境 下 免费 开源 的 代码 编辑 器 ,支持 C、C++、Java、C#、 
XML、HTML、PHP、JavaScript 等 多 种 语言 。 


Notepad++ 是 一 套 非常 有 特色 的 自由 软件 的 纯 文字 编辑 器 ,有 完整 的 中 文化 接口 及 支 
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1.26 Zend Studio 常用 的 快捷 键 


持 多 国语 言 撰 写 的 功能 (UTF8 技术 ) 。 它 的 功能 比 Windows 中 的 Notepad 强大 ,除了 可 以 
用 来 制作 一 般 的 纯 文字 说 明文 件 外 , 它 还 十 分 适合 作为 的 撰写 计算 机 程序 的 编辑 器 。 
Notepad++ 不 仅 有 语法 高 亮度 显示 功能 ,也 有 语法 折 笃 功能 ,并 且 支 持 宏 以 及 扩充 基本 功能 
的 外 挂 模块 。 
Notepad++ 编 辑 器 界面 如 图 1. 27 所 示 ,其 主要 功能 如 下 : 
。 内 置 多 达 27 种 语法 高 亮度 显示 ,包括 各 种 常见 的 源 代码 、 脚 本 ,能 够 很 好 地 支持 
. nfo 文件 的 查看 、 支 持 自 定义 语言 。 
。 可 自动 检测 文件 类 型 ,根据 关键 字 显 示 节 点 ,节点 可 自由 折 释 /打开 ,还 可 显示 缩 进 
引导 线 , 代 码 显 示 层 次 感 强 。 
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26 Ssubmit = Sthis-»createElement('submit', 'HEX'); 
27 Sthis-»addrloment (Ssubmit) ; 
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图 1.27 Notepad++ 编 辑 器 


。 可 打开 双 窗 口 .在 分 窗口 中 又 可 打开 多 个 子 窗口 ,可 以 调整 显示 比例 。 

。 提供 了 一 些 有 用 工具 ,例如 邻 行 互 换 位 置 、 宏 功能 等 。 

。 可 显示 选中 文本 的 字 节 数 ,而 不 是 一 般 编 辑 器 所 显示 的 字数 。 

。 正则 匹配 字符 串 及 批量 替换 。 

。 强大 的 插件 机 制 ,扩展 了 编辑 功能 。 

下 面 简单 介绍 Notepad++ 编 辑 器 的 常用 操作 ,这 里 以 6. 6. 7 版 本 为 例 。 

l. 编辑 器 语言 设置 

Notepad++ 编 辑 器 安装 完毕 后 ,选择 菜单 栏 中 的 “设置 "|“ 首 选项 ”菜单 项 ,弹出 “首选 
项 ”对 话 框 。 切 换 到 “常用 ”选项 卡 ,在 “界面 语言 "下 拉 列 表 中 选择 “中 文 简体 ”, 将 编辑 器 界 
面 语言 从 英文 转变 为 简体 中 文 。 

2. 语言 格式 设置 

Notepad++ 默 认 提供 了 许多 语言 的 代码 高 亮 功能 ,如 果 程 序 没有 自动 识别 ,选择 菜单 栏 
中 的 “设置 ?|* 语 言 格式 设置 ?菜单 项 ,弹出 “语言 格式 设置 ?对 话 框 , 选 择 语言 类 型 后 , 即 可 设 
置 语言 显示 的 背景 颜色 及 字体 样式 等 。 

3. 代码 提示 

在 Notepad++ 中 ,默认 的 代码 自动 完成 快捷 键 是 Ctrl 十 Enter。 例 如 在 PHP 文件 中 输 
入 c, 然 后 按 Ctrl 十 Enter, 就 会 显示 出 来 代码 提示 。 通 过 快捷 键 有 时 不 太 方 便 ,可 以 在 “首选 
项 对话 框 的 “自动 完成 ?选项 卡 中 选择 * 所 有 输入 均 启用 自动 完成 ” 复 选 框 “ 输 入 时 提示 函 
数 ”" 复 选 框 ,来 设置 自动 提示 功能 。 

4. 书签 功能 

书签 的 设置 在 如 图 1. 27 所 示 的 中 间 编 辑 区 中 进行 。 在 编辑 区 中 的 行 号 旁边 单 击 ,或 者 
是 在 定位 的 行 上 按 Ctrl 十 F2 快捷 键 ,会 发 现 书 签 栏 中 多 出 了 一 个 蓝 色 圆 点 ,这 个 蓝 色 圆 点 
即 为 书签 标记 。 再 次 单 击 书签 标记 ,或 者 是 在 书签 标记 行 按 Ctrl 十 F2 快捷 键 ,可 以 取消 
书签 。 

当 光 标 移 到 编辑 区 中 的 其 他 位 置 时 , 按 下 F2 功能 键 , 即 可 回 到 标签 行 。 在 设置 有 多 个 
书签 的 文件 中 ,通过 功能 键 F2 移动 光标 到 上 一 个 书签 ,通过 Shift 十 F2 组 合 键 将 光标 移动 
到 下 一 个 书签 。 

5. 列 编辑 功能 

Notepad++ 的 列 编辑 就 是 在 光标 所 在 列 插入 文本 或 者 数字 ,可 以 通过 选择 “编辑 ”|* 列 
块 模式 ”或 “ 列 块 编辑 ”菜单 项 完成 ,也 可 以 通过 按 快 捷 键 Alt 十 C 来 完成 。 

例如 ,要 在 图 1. 27 所 示 的 代码 前 加 上 自己 的 行 号 ,可 以 按 下 列 步骤 进行 操作 : 

CD 将 光标 定位 到 代码 的 第 1 行 第 1 列 。 

(2) 按 快捷 键 Alt 十 C, 弹 出 “ 列 编辑 ”对 话 框 。 

G) 在 “ 列 编辑 ”对 话 框 中 选择 “插入 数字 ”, 设 置 “初始 值 ”与 “ 增 量 ”。 

(4) 单 击 该 对 话 框 中 的 “确定 ”按钮 ,完成 行 号 的 设置 ,如 图 1. 28 所 示 。 

注意 ,这 里 设置 的 行 号 布 满 文件 中 光标 所 在 行 下 面 的 所 有 代码 行 。 如 果 要 对 选择 的 行 
进行 列 操作 , 先 选择 “编辑 "|* 列 块 模式 ”菜单 项 、 启 动 列 编辑 模式 ,然后 用 "Alt 十 鼠标 左 键 ” 
或 Alt 十 Shift 十 Arrow Key 选择 要 操作 的 行 ,最 后 在 “ 列 编辑 ”对 话 框 中 进行 设置 。 
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1.28 Notepad++ 列 编辑 


6. 颜色 标记 

颜色 标记 就 是 给 选 定 的 文本 设置 定义 的 格式 。 其 使 用 方法 非常 简单 ,选中 需要 标记 的 
文本 ,右键 选择 标记 的 格式 即 可 ,用 同样 的 方法 也 可 以 清除 设置 的 格式 。 

7. Nppexport 插件 

Nppexport 是 Notepad++ 默 认 安装 的 插件 ,通过 这 款 插件 可 以 方便 地 导出 着 色 以 后 的 
代码 。 其 功能 通过 “插件 "|Nppexport 下 的 子 菜单 项 完成 。 

8. Converter 插件 

Converter 也 是 一 款 Notepad++ 默 认 安 装 的 搬 件 ,通过 这 款 搬 件 可 以 方便 地 进行 各 种 数 
Ted. Hou f SE f IET | Converter 下 的 子 菜单 项 完成 。 


1.3.3 技术 文档 


在 Zend Framework 项 目 开 发 过 程 中 ,用 户 会 经 常 查阅 一 些 技术 文档 ,以 了 解 某 个 函数 
的 调用 方法 或 某 个 类 的 结构 等 ,这 就 需要 在 开发 前 做 好 技术 资料 的 收集 与 整理 工作 。 

由 于 Zend Framework 项 目 涉及 的 知识 面 非常 广 , 因 此 ,在 开发 过 程 中 需要 查阅 的 资料 
会 非常 多 ,另外 ,开发 者 的 知识 结构 .专业 水 平 不 同 ,查阅 的 技术 文档 类 型 也 会 有 所 不 同 , 作 
者 认为 下 面 两 个 手册 应 该 是 大 家 必须 要 准备 的 。 

1. PHP 使 用 手册 

通过 PHP 使 用 手册 可 以 查询 到 PHP 函数 的 定义 及 调用 方法 ,也 可 以 了 解 随 着 PHP 
版 本 的 升级 而 被 废弃 的 函数 。 当 然 , 该 手册 中 的 某 些 示 例 代码 也 可 以 直接 复制 到 项 目 中 。 
其 界面 如 图 1. 29 所 示 。 

2. Zend Framework 使 用 手册 

Zend Framework 使 用 手册 是 学 习 Zend Framework 必 不 可 少 的 技术 资料 ,是 开发 人 员 
进行 项 目 开发 的 得 力 助 手 , 如 图 1. 30 所 示 。 通 过 该 手册 不 仅 可 以 查询 到 Zend Framework 
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* cal days in month 一 返回 某 个 历法 中 某 年 中 某 月 的 天 数 
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的 组 件 结构 ,了 解 其 功能 ; 还 可 以 参考 其 给 出 的 示例 程序 ,以 及 用 户 在 使 用 过 程 中 碰 到 问题 
后 所 给 出 的 解决 方案 。 大 家 需要 注意 的 是 ,手册 对 应 着 不 同 的 PHP 或 Zend Framework 版 


本 ,各 版 本 之 间 会 有 一 些 差别 。 
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图 1.30 Zend Framework 使 用 手册 


1.4 本 章 小 结 


本 章 在 对 PHP 的 Zend Framework 框架 技术 概述 的 基础 上 ,重点 介绍 其 应 用 开发 的 环 
境 搭建 与 配置 过 程 以 及 Zend Studio 与 Notepad++ 两 款 开发 工具 的 使 用 方法 。 除 本 章 介 绍 
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的 开发 环境 与 工具 之 外 ,还 有 许多 其 他 的 配置 方案 ,大 家 可 以 根据 自身 情况 自由 选择 。 
Zend Framework 应 用 是 跨 平台 的 ,可 以 在 绝 大 多 数 支持 PHP 环境 的 平台 上 运行 。 

本 章 内 容 是 为 初学 者 提供 的 ,已 经 有 了 PHP 项 目 开 发 经 验 的 读者 ,在 了 解 了 Zend 
Framework 的 常用 组 件 、 安 装 过 程 之 后 ,可 以 略 过 本 章 的 其 他 内 容 , 直接 进入 下 一 章 的 
学 习 。 


第 2 章 Zend Framework 结构 及 原理 


Zend Framework 框架 是 基于 MVC 模式 的 ,其 项 目 有 相对 固定 的 目录 结构 。 这 种 目录 
结构 形式 是 由 Zend Framework 框架 的 路 由 原理 与 文件 搜索 机 制 决定 的 ,所 以 在 进行 项 目 
开发 时 要 严格 遵循 这 种 格式 ,相对 固定 的 结构 有 利于 项 目 后 期 的 功能 扩展 与 维护 。 

本 章 介 绍 Zend Framework 项 目的 创建 及 运行 原理 。 


2.1 Zend Framework 项 目的 创建 和 结构 


第 1 章 创 建 了 Zend Framework 的 开发 环境 ,并 成 功 安装 .运行 了 一 个 使 用 Zend 
Framework 组 件 Zend. Date 的 PHP 文件 Date. php ,在 浏览 器 页 面 中 正确 地 输出 了 当前 日 
期 。 下 面 开 始 创建 我 们 的 第 一 个 基于 Zend Framework 框架 的 项 目 。 


2.1.1 Zend Framework 项 目的 创建 


创建 Zend Framework 项 目 有 多 种 方法 ,可 以 根据 Zend Framework 框架 的 特点 手工 构 
建 , 也 可 以 用 Zend Framework 自 带 的 命令 工具 创建 ,还 可 以 用 PHP 的 集成 开发 环境 Zend 
Studio 自动 创建 。 

l. 使 用 集成 开发 环境 

在 新 的 Zend Studio 集成 开发 环境 的 版 本 中 岩 入 了 Zend Framework 库 文件 及 开发 工 
具 , 因 此 ,可 以 通过 应 用 程序 向 导 自 动 生成 Zend Framework 应 用 程序 。 

(1) 打开 Zend Studio 集成 开发 环境 ,选择 工作 区 为 D:\xampp\htdocs 目录 ,然后 选择 
File| New| Local PHP Project 菜单 项 ,弹出 如 图 2. 1 所 示 的 New Local PHP Project 对 话 框 。 

(2) 在 Project Name 文本 框 中 输入 项 目 名 称 , 这 里 案例 项 目 名 为 wmProject; 在 
Content 单 选 组 中 选择 Zend Framework; 在 Version 下 拉 列 表 框 中 选择 Zend Framework 
框架 版 本 ,本 书 项 目 选 择 Zend Framework 1. 12. 5, 如 图 2. 2 所 示 。 当 然 , 也 可 以 通过 
Version 下 拉 列 表 框 中 的 Other 选项 打开 如 图 2. 3 所 示 的 对 话 框 加 载 Zend Framework 的 
最 新 版 本 或 自己 下 载 的 其 他 版 本 的 库 文 件 。 

(3) 单 击 图 2. 2 所 示 的 属性 页 对 话 框 中 的 Finish 按钮 , 即 可 生成 如 图 2. 4 所 示 的 Zend 
Framework 项 目 。 

2. 使 用 Zend Framework 命令 工具 

Zend Framework 自 带 了 ZF Tool 命令 工具 ,用 来 快速 创建 项 目 、 控 制 器 、 模 型 .视图 以 
及 表单 等 资源 。 在 下 载 Zend Framework 后 的 压缩 包 里 有 一 个 bin 文件 夹 ,其 中 有 zf. bat, 
zf. php 和 zf. sh 3 个 文件 ,zf. bat 就 是 Windows 系统 下 使 用 的 命令 文件 。 
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图 2.1 新 建 本 地 PHP 项 目 对 话 杠 


2.2 新 建 PHP 项 目 信息 


Add New Zend Framework Library 
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图 2.3 添加 Zend Framework 其 他 版 本 
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图 2.4 新 建 Zend Framework 项 目 界面 


1) 直接 使 用 ZF Tool 工具 

打开 Windows DOS 命令 窗口 ,将 目录 切换 到 下 载 的 Zend Framework 的 bin 文件 夹 
下 ,输入 命令 zf. bat create project f:/wmProject, 即 可 在 下 盘 根 目录 下 创建 项 目 wmProject, 如 
图 2.5 和 图 2.6 所 示 。 


Tp le E 


图 2.5 新 建 Zend Framework 项 目 命令 窗口 
2) 先 安装 ZF Tool 工具 再 使 用 
使 用 上 述 命令 方式 创建 Zend Framework 项 目 是 直接 在 下 载 的 Zend Framework 文件 
夹 中 进行 操作 的 ,不 是 很 方便 ,所 以 一 般 会 将 命令 文件 添加 到 系统 的 搜索 路 径 当 中 ,这 样 在 
用 命令 创建 项 目 时 就 可 以 直接 在 拟 建 项 目 所 在 的 目录 中 进行 操作 了 。 
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图 2.6 用 命令 方式 新 建 Zend Framework 项 目 目录 


安装 ZF Tool 工具 的 步骤 如 下 : 

(1) Æ C:\Program Files 目录 下 创建 Zend 新 文件 夹 。 

(2) 将 下 载 的 Zend Framework 解压 包 中 的 bin 文件 夹 复 制 到 Zend 文件 夹 中 。 

(3) 将 C:\Program Files\Zend\bin 目录 添加 到 系统 环境 变量 path 中 。 

在 安装 好 ZF Tool 命令 工具 后 ,打开 如 图 2. 5 所 示 的 Windows 命令 窗口 ,将 目录 切换 
到 下 盘 根 目录 下 ,输入 命令 : 


zf create project wmProject 


即 可 在 下 盘 根 目录 下 创建 一 个 名 为 wmProject 的 Zend Framework 项 目 。 

3. 使 用 Zend Studio 集成 环境 中 的 ZF Tool 工具 

打开 Zend Studio 集成 开发 环境 ,选择 Project| Zend Tool 菜单 项 ,弹出 如 图 2.7 所 示 的 
命令 窗口 ,输入 命令 : 

zf create project wmProject 
即 可 在 Zend Studio 集成 开发 环境 的 项 目 工 作 区 中 创建 一 个 名 为 wmProject 的 Zend 
Framework 项 目 。 这 时 ,如 果 项 目 工 作 区 的 目录 对 应 D:\xampp\htdocs 目录 ,项 目 wmProject 
就 被 创建 在 了 本 地 服务 器 上 。 
2.1.2 Zend Framework 命令 

Zend Framework 提供 的 命令 工具 为 我 们 的 应 用 开发 提供 了 方便 ,安装 Zend Framework 
的 ZF Tool 工具 后 ,在 Windows 的 命令 窗口 中 直接 输入 : 


zf? 


命令 ,就 会 显示 ZF Tool 命令 的 所 有 说 明和 语法 提示 ,如 图 2.8 所 示 。 
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图 2.7 输入 命令 


说 明 XA 


关于 ZF Tool 命令 ,这 里 不 给 出 详细 的 语法 


下 其 概貌 。 在 接 下 来 的 项 目 开 发 过 程 中 会 频繁 地 使 用 这 些 命 令 , 到 时 再 详细 讲解 。 


2.1.3 Zend Framework 项 目 结构 


pr -E 人 : ; : -Wi H 2E H , m 
打开 上 面 创建 的 Zend Framework 项 目 wmProject, 其 项 目 结构 如 图 2. 9 所 示 。 
D emm eed 0 eS lo MES 
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Note: You may in any place of the above usage string to as a $8 scripts 
w: » B error 
? version" will list all available actions for the v a edax 
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4 (9 docs 
includedL-1] D README SG 
f show version.? to get specific help on t| © library 
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Config Jg) index.php. 
create config 4 (B tests 
how config 9 application 
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图 2.8 显示 ZF Tool 命令 的 所 有 说 明和 语法 提示 


图 2.9 项 目 结构 


到 2.8 所 示 的 方法 了 解 


这 是 Zend Framework 的 基本 目录 结构 ,当然 还 可 以 根据 具体 情况 添加 一 些 新 的 目录 
与 文件 。 例 如 ,在 public 目录 下 添加 存放 图 片 文件 的 images 目录 、 存 放样 式 文件 的 CSS E 
录 以 及 存放 JavaScript 脚本 的 JS 目录 等 。Zend Framework 目录 中 各 文件 夹 的 作用 见 表 2.1. 
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32.1 Zend Framework 项 目的 文件 夹 及 说 明 


文 件 x 说 明 
uU 应 用 程序 主 目录 ,包含 应 用 程序 全 部 文件 ,一 般 为 非 公开 文件 ,例如 配置 文 
application 
件 等 
application\configs 项 目 配置 文件 目录 


application\modules 


多 模块 目录 ,例如 admin( 后 台 管 理 )、default( 默 认 前 台 管 理 ) 等 。 由 于 在 上 
面 的 项 目 中 还 没有 创建 模块 ,在 图 2.9 所 示 的 目录 结构 中 该 目录 暂时 不 存 


在 (第 7 章 介绍 ) 
application\controllers 控制 器 目录 
application\models 模型 目录 
application\views 视图 目录 


application\views\helpers 


存放 “动作 助手 ”(action helper) 的 目录 


Bootstrap. php 


应 用 程序 启动 文件 ,用 于 引导 应 用 程序 、 注 册 并 初始 化 组 件 


docs 文档 和 说 明文 件 

p 库 文件 目录 。 应 用 程序 引用 的 第 三 方 类 库 和 自己 编写 的 类 库 在 这 里 自动 
library 加 载 

biblie 应 用 程序 的 公开 文件 目录 ,也 是 项 目的 根 目录 ,存放 可 以 被 用 户 访问 的 文件 ， 


例如 JavaScript, CSS 和 图 片 等 ,项 目的 主页 面 文 件 index. php 也 存放 在 这 里 
存放 测试 文件 。 如 果 系 统 安装 了 PHP Unit, 则 在 使 用 ZF Tool 创建 控制 器 
方法 时 会 自动 在 该 文件 夹 下 创建 测试 文件 


tests 


2.2 Zend Framework 项 目的 运行 


上 面 用 不 同 的 方法 在 不 同 的 目录 中 创建 了 Zend Framework 项 目 wmProject, 并 且 了 解 
了 它 的 目录 结构 及 首页 文件 index. php 的 存放 位 置 , 下 面 运行 通过 Zend Studio 在 D:\ 
xampp\htdocs 中 创建 的 wmProject 项 目 。 

1. 直接 运行 

COD 打开 XAMPP 的 控制 面板 ,启动 Apache 服务 器 。 

(2) 启动 IE 或 其 他 浏览 器 。 

(3) 在 浏览 器 地 址 栏 中 输入 http://localhost/wmProject/public, 即 可 看 到 如 图 2. 10 
所 示 的 主页 面 效 果 。 由 于 页 面 中 的 背景 图 片 取 自 Zend 公司 网 站 ,所 以 如 果 计 算 机 没有 连 
接 外 网 ,将 看 不 到 背景 图 片 。 

2. 通过 虚拟 主机 运行 

在 第 1 章 中 已 经 创建 了 名 为 wmoams. com 的 虚拟 主机 ,其 根 目 录 为 D:\xampp\htdocs\ 
wmProject\public。 这 就 是 说 ,http://wmoams. com 即 为 我 们 创建 的 Zend Framework 项 
目 wmProject 的 系统 域名 。 

启动 Apache 服务 器 ,在 浏览 器 中 输入 http://wmoams. com, 即 可 看 到 如 图 2. 10 所 示 
的 欢迎 页 面 效果 。 另 外 ,在 浏览 器 中 输入 http://wmoams. com/index 3X http://wmoams. 
com/index/index, 也 会 看 到 同样 的 页 面 效 果 。 

正常 情况 下 ,Zend Framework 应 用 的 访问 URL. 应 该 为 “域名 十 模块 名 十 控制 器 名 十 


动作 名 ”, 那 么 为 什么 上 述 URL 省 略 了 部 分 内 容 也 可 以 访问 呢 ? 


这 是 因为 在 Zend Framework 


中 默认 模块 名 (Default) ,默认 控制 器 名 (Index) 和 默认 首页 动作 名 (index) 都 是 可 以 省 略 的 。 
Zend Framework 的 运行 应 当 采 用 方法 2 的 方式 ,这 也 是 Zend Framework 项 目的 标准 

运行 方式 。 采 用 方法 1 虽然 可 以 运行 Zend Framework 项 目 , 但 项 目 文件 中 的 URL 需要 进 

行 特别 处 理 , 例 如 采用 baseURL0O 函 数 获取 URL 等 ,这 对 初学 者 来 说 具有 一 定 的 难度 。 


文件 日 ”编辑 ”查看 (VW) 收藏 夫 (A) IAD 帮助 (H) 


O- E httoz//lecalhost/wmprojec/publicr $ ~| |*| x Gs sing Pr 


xr ium | vs ous v p) 网 页 快讯 库 v p) 自 定义 链接 


回 rapy/ocalhosywmprojecyp- -B-ce-mme- 2207 IRO 9- " 


Welcome to the 


This is your project's main page 
ZF 


Helpful Links 


完成 | (000 Q internet | RAT SA 
图 2.10 Zend Framework 项 目 主页 面 
3. 改变 视图 内 容 


v Rioo% ~ 


从 表 2. 1 可 知 ,Zend Framework 项 目的 主页 文件 index. php 存放 在 public 目录 下 4T 


开 该 文件 看 一 下 里 面 的 代码 


<?php 
// Define path to application directory 
defined('APPLICATION PATH') 


|| define('APPLICATION PATH',realpath(dirname( FILE ). 


// Define application environment 
defined('APPLICATION ENV') 


'/../application')); 


|| define('APPLICATION ENV', (getenv( APPLICATION ENV') ? getenv( APPLICATION ENV') : 


'developnent')); 
$ paths = array(realpath(APPLICATION PATH . '/../library')); 


if (function exists('zend deployment library path') && zend deployment library path( 'Zend 


Framework 1')) ( 


$ paths[] = zend deployment library path('Zend Framework 1'); 


) 
$ paths[] = get include path(); 
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set include path(implode(PATH SEPARATOR, $ paths) ); 
/xx Zend Application * / 
require once '"Zend/Application. php'; 
// Create application, bootstrap, and run 
$ application = new Zend Application( 
APPLICATION ENV, 
APPLICATION PATH . '/configs/application. ini' 
) 
$ application- » bootstrap() 
-»run(); 


显然 ,这 些 代 码 并 不 是 我 们 熟悉 的 HTML 页 面 。 但 从 图 2. 10 所 示 的 运行 效果 可 以 看 
到 ,浏览 器 显示 的 页 面 上 既 有 图 片 又 有 文本 ,还 有 超级 链接 ,内 容 还 是 非常 丰富 的 。 那 么 ,这 
些 页 面 元 素 到 底 是 从 哪里 来 的 呢 ? 

打开 application\views\scripts\index\index. phtml 文件 ,看 一 下 里 面 的 代码 : 


<style> 
a:link, 
a:visited 
( 
color: & 0398CA; 
) 
span# zf - name 
{ 
color: &91BE3F; 


) 

div # welcome 

t 
color: # FFFFFF; 
background - image: url(http://framework. zend.com/images/bkg header. jpg); 
width: 600px; 
height: 400px; 
border: 2px solid & 444444; 
overflow: hidden; 
text - align: center; 

) 

div# more - information 

{ 
background- image: url(http://framework. zend. com/images/bkg_body - bottom. gif); 
height: 100 $% ; 

} 

</style> 


<div id = "welcome"> 
< hl > Welcome to the < span id = "zf — name"» Zend Framework!</span></hl > 
< h3» This is your project's main page </h3 > 
<div id- "more- information"» 
<p>< ing src = "http: //framework. zend. com/images/PoweredBy ZF 4LightBG. png" /></p> 
<p> 
Helpful Links: <br /> 
<a href = "http: //framework. zend. com/"> Zend Framework Website </a> | 


<a href = "http://framework. zend. com/manual/en/"> Zend Framework Manual </a> 


</p> 
</div> 
</div> 


分 析 上 面 的 代码 ,可 知 这 里 才 是 真正 的 主页 页 面 。 也 就 是 说 ,访问 项 目的 根 目 录 中 的 
public\index. php 文件 ,结果 呈现 出 来 的 是 application\views\scripts\index\index. phtml 


文件 中 的 内 容 。 


将 index. phtml 文件 中 的 代码 全 部 删除 ,在 页 面 中 重新 书写 一 行文 本 : 


Welcome to http://www. wmstudio. net.cn 


刷新 页 面 ,会 看 到 首页 变 成 了 如 图 2. 11 所 示 的 效果 。 


Ol Oe hip/mmoamscom E E E a ?| 
文件 四。 S80 SEV ERW IAD 帮助 (H) 

dudum |b 疯 建议 网 站 ” 县 ] 网 页 快 汛 库 v p 自 定 义 链接 
[f htp/jemoamscon; | | A- D-E e- MEO. e$9- IBQ- 


Welcome to httpy/www_wmstudio net cn 


图 2.11 修改 页 面 内 容 后 显示 的 效果 


这 说 明 , 在 浏览 器 中 访问 项 目的 根 目录 确实 访问 到 了 application\views\scripts\index 
目录 下 的 index. phtml 文件 。 另 外 ,如 果 打 开 application\controllers\indexController. php 


文件 ,并 在 其 方法 indexAction 中 添加 如 下 阴影 部 分 代码 : 


<?php 
class IndexController extends Zend Controller Action 
{ 
public function init() 
{ 
/ * Initialize action controller here * / 
) 
public function indexAction() 
{ 
// 添 加 代码 
echo <br />'; 
echo 'welcome to Zend Framework IndexController'; 
} 
public function mainAction() 
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t 
// action body 
} 
} 


刷新 页 面 ,会 看 到 首页 变 成 了 如 图 2. 12 所 示 的 样子 。 


Lai 


ES 


Ol Ue omoose -sxlgse P 7| 
XD SE) SEV HERA IAD AH 

xpexm |b 关于 网 上  plmOuesuev p) aE 

Æ htip//wmoamscom/ | | A - E) - c - mOr 安全” IAO 


Welcome to http-//www.wmstudio.net.cn 
welcome to Zend Framework IndexController 


2.12 修改 控制 器 方法 内 容 后 显示 的 效果 


从 图 2.12 所 示 的 页 面 效果 可 以 看 出 ,在 IndexController 控制 器 的 方法 indexAction 中 
添加 的 文本 也 在 页 面 中 有 了 显示 。 

由 此 可 以 得 出 结论 ,如果 要 修改 首页 中 的 显示 内 容 , 既 可 以 在 视图 文件 中 进行 ,也 可 以 
在 控制 器 的 方法 中 进行 。 这 也 说 明了 项 目 根 目录 中 的 index. php 文件 Index 控制 器 Index 
控制 器 的 index 方法 以 及 视图 文件 views\scripts\index\index. phtml 之 间 必 定 存在 着 某 种 
联系 。 


2.3 Zend Framework 运行 原理 


dn 53€ 3E 18 46 2. 2 节 中 Zend Framework 应 用 程序 的 运行 机 制 ,必须 了 解 Zend Framework 
的 工作 原理 和 流程 。 要 彻底 地 明白 这 一 点 ,并 不 是 一 件 容易 的 事 , 对 于 初学 者 来 说 也 没有 必 
要 一 下 子 全 部 了 解 。 下 面 从 两 个 方面 简单 地 介绍 一 下 。 


2.3.1 MVC 模式 


Zend Framework 框架 是 一 个 良好 的 MVC 模式 的 框架 ,所 谓 MVC 模式 ,其 实 是 一 种 
软件 构架 模型 , 即 模型 (Model) 一 视图 (View) 一 控制 器 (Controller) 模 型 , 它 把 软件 系统 分 
成 3 个 基本 部 分 , 即 模型 .视图 和 控制 器 ,将 数据 的 处 理 与 显示 完全 分 离 。 

1. 模型 

模型 用 于 封装 与 程序 的 业务 逻辑 相关 的 数据 ,以 及 处 理 这 些 数据 的 方法 。 它 拥有 对 数 
据 直 接 访问 的 权利 ,包括 对 数据 库 的 直接 访问 .。“ 模 型 ?并 不 关心 自身 会 被 如 何 显示 ,或 是 被 


如 何 操 作 。 例 如 ,在 本 书 的 案例 项 目 一 一 微 梦 办 公 自 动 化 管理 系统 (WMOAMS) 一 一 中 ,可 
以 把 “公文 ”等 数据 封装 在 模型 Wm_Model_File 类 的 对 象 里 .并 在 Wm Model File 对 象 中 
添加 一 些 对 “公文 ”进行 访问 的 方法 ,包括 添加 “公文 ”修改 “公文 ?和 删除 “公文 ”等 。 

2. 视图 

视图 用 来 显示 数据 和 处 理 用 户 交互 ,把 模型 数据 以 特定 形式 展示 给 用 户 。 在 视图 中 一 
般 没有 程序 逻辑 , 它 只 是 从 模型 获得 显示 信息 ,对 于 相同 的 信息 可 以 有 多 个 不 同 的 显示 形式 
或 视图 。 例 如 在 本 书 案例 WMOAMS 系统 中 , 当 Model 改变 时 ,视图 的 责任 是 保持 模型 与 
其 显示 之 间 的 一 致 性 。 

3. 控制 器 

控制 器 用 于 控制 应 用 程序 的 流程 ,起 到 不 同 层面 间 的 组 织 作用 。 它 处 理事 件 并 做 出 响 
应 ,事件 包括 用 户 的 行为 和 数据 模型 上 的 改变 。 例 如 在 WMOAMS 系统 中 ,我 们 就 创建 了 
一 个 中 心路 由 的 FileController 控制 器 ,用 户 的 所 有 关于 “公文 "数据 的 请 求 都 进入 这 个 控制 
器 ,该 控制 器 根据 请 求 的 类 型 来 操作 Wm_Model_File* 公 文 ”模型 。 

模型 .视图 与 控制 器 的 分 离 使 应 用 程序 将 数据 的 保存 ,处理 与 数据 的 显示 功能 分 开 , 降 
低 了 组 件 之 间 的 耦合 度 。 

在 经 典 的 MVC 模式 中 ,事件 由 控制 器 处 理 ,控制 器 再 根据 事件 的 类 型 改变 模型 或 视 
图 ,反之 亦 然 。 具 体 地 说 ,每 个 模型 对 应 着 一 系列 的 视图 列表 ,这 种 对 应 关系 通常 采用 注册 
完成 , 即 把 多 个 视图 注册 到 同一 个 模型 。 当 模型 发 生 改 变 时 ,模型 向 所 有 注册 过 的 视图 发 送 
通知 , 接 下 来 ,视图 从 对 应 的 模型 中 获得 信息 ,然后 完成 视图 显示 的 更 新 。 

相对 于 早期 的 MVC 程序 设计 思想 , Web 环境 下 的 MVC 模式 又 有 所 不 同 。 因 为 对 于 
一 般 应 用 程序 而 言 , 可 以 将 视图 注册 给 模型 , 当 模型 数据 发 生 改 变 时 ,即时 通知 视图 页 面 做 
出 相应 改变 ; 而 对 于 Web 应 用 而 言 , 即 使 将 多 个 视图 页 面 注册 给 同一 个 模型 , 当 模 型 发 生 
变化 时 ,模型 也 无 法 主动 发 送 消 息 给 视图 页 面 。 因 为 ,Web 应 用 都 是 基于 请 求 /响应 模式 
的 ,只 有 当 用 户 请 求 浏览 该 页 面 时 控制 器 才 负 责 调用 模型 数据 更 新 视图 页 面 。 

通过 上 面 的 分 析 , 可 以 用 图 2. 13 表示 Zend Framework 项 目 中 MVC 架构 的 工作 流程 。 


浏览 器 


控制 器 。 |Web 容 器 


视图 0 


图 2.13 Web 应 用 中 的 MVC 模式 流程 


在 2.2 节 中 ,通过 修改 Index 控制 器 的 index 方法 改变 了 主页 页 面 的 显示 内 容 ,说 明了 
视图 与 控制 器 的 关联 关系 ,这 种 关系 正 是 图 2. 13 描述 的 。 由 于 文本 数据 没有 存储 在 数据 库 
中 ,因此 还 不 能 体现 出 与 模型 的 联系 。 

这 里 需要 强调 的 是 , MVC 并 不 是 针对 某 种 特定 的 语言 所 特有 的 设计 思想 ,也 并 不 是 
Web 应 用 所 特有 的 模式 , 它 是 所 有 面向 对 象 程序 设计 语言 都 应 该 遵守 的 规范 。 
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2.3.2 Zend Framework 路 由 与 分 发 规则 


图 2. 13 描述 的 工作 流程 ,只 有 中 间 和 右边 部 分 对 Zend Framework 是 正确 的 。 回 顾 一 
下 在 2.2 节 中 所 讲 的 内 容 ,运行 项 目 时 输入 的 URL 地址 是 http://wmoams. com, 这 里 很 明 
显 访问 的 是 项 目 根 目录 public 中 的 index. php 文件 ,并 没有 直接 访问 控制 器 。 所 以 ， 
图 2. 13 的 左边 所 描述 的 浏览 器 与 控制 器 的 请 求 /响应 方式 对 Zend Framework 应 用 来 说 是 
不 正确 的 。 

在 Zend Framework 应 用 中 ,浏览 器 与 控制 器 之 间 还 存在 着 一 个 “桥梁 ”, 这 个 “桥梁 ” 便 
是 前 端 控制 器 (Front Controller), Zend Framework 不 仅 采用 了 MVC 模式 ,还 实现 了 前 端 
控制 模式 。 这 就 意味 着 访问 Zend Framework 应 用 的 所 有 HTTP 请 求 都 会 被 转发 到 同一 
DAH ,然后 再 路 由 到 相应 的 控制 器 。 这 个 入 口 便 是 项 目 public 根 目录 下 的 index. php X 
件 , 我 们 把 它 称 为 引导 文件 。 

Zend Framework 通过 URL Rewrite 技术 实现 前 端 控制 。 在 public 根 目 录 下 ,用 户 可 
以 看 到 有 一 个 名 为 . htaccess 的 文件 ,其 内 容 如 下 : 

RewriteEngine On 

RewriteCond % (REQUEST FILENAME) - s [OR] 

RewriteCond % (REQUEST FILENAME) — 1 [OR] 

RewriteCond % (REQUEST FILENAME) - d 

RewriteRule ^. * $ — [NC,L] 

RewriteCond $ (REQUEST URI):: $1^(/. * )(. * ) ::M2$ 

RewriteRule ^(. * ) $ - [E= BASE: $1] 

RewriteRule ^(. * ) $ % (ENV:BASE) index. php [NC, L] 

以 上 配置 将 根 目 录 下 没有 的 文件 和 路 径 请 求全 部 转发 到 了 index. php 上 ,然后 通过 
index. php 来 路 由 。 在 配置 文件 中 有 一 些 正则 表达 式 ,如 果 读 者 不 太 理解 ,请 查阅 其 他 PHP 
教程 。 

上 面 的 流程 发 生 在 前 端 控制 器 内 部 ,这 个 过 程 常常 是 在 前 端 控制 器 调用 dispatch O Jy 
法 时 触发 的 ,大 致 可 以 分 解 为 以 下 12 个 步骤 : 

CD 产生 一 个 请 求 Request, 即 创建 一 个 Request Object 对 象 。 

(2) 路 由 事件 routeStartup 被 触发 。 

(3) 路 由 器 Router 开始 处 理 这 个 请 求 , 从 中 获取 请 求 信息 。 

(4) 路 由 事件 routeShutdown 被 触发 ,路 由 过 程 结束 。 

(5) 派 遗事 件 dispatchLoopStartup 被 触发 。 

(6) 派 遗 preDispatch 事件 被 触发 。 

(7) 派遣 过 程 中 调用 动作 控制 器 (action controller) 。 

(8) 动作 控制 器 将 处 理 完成 信息 直接 写 入 响应 对 象 (response Object) 。 

(9) 派 遗 postDispatch 事件 被 触发 。 

(10) 检测 派遣 标志 , 即 检查 是 否 还 有 动作 没有 完成 ,如 果 有 再 次 进入 派 遗 循环 。 

(11) WÈ FAF dispatchLoopShutdown 被 触发 。 

(12) 产生 的 响应 Response 被 返回 。 

上 面 的 流程 有 点 复杂 ,这 里 不 做 详细 说 明 。 如 果 大 家 有 兴趣 ,可 以 把 Zend Framework 


库 中 的 Zend. Controller. Front 类 和 Zend. Controller Plugin Broker 类 打开 研究 一 下 。 这 
两 个 类 文件 分 别 位 于 Zend Framework 类 库 的 Zend\Controller 目录 和 Zend V Controller V 
Plugin 目录 下 。 


2.3.3 Zend Framework 访问 流程 


通过 上 面 的 分 析 , 针 对 浏览 器 中 的 http://wmoams. com 请 求 ,Zend Framework 应 用 
的 大 致 访问 流程 是 “ 重 写 文 件 . htaccess” 一 “引导 文件 index. php” 王 “配置 文件 application. 
ini” 一 “启动 类 Bootstrap” 一 "默认 控制 器 IndexController” 一 “视图 文件 index. phtml”。 


2.4 Zend Framework 文件 


上 面 对 Zend Framework 应 用 的 运行 原理 进行 了 简单 的 分 析 ,大 家 可 能 还 是 不 太 明 白 ， 
下 面 针 对 项 目 中 的 代码 再 来 分 析 一 下 Zend Framework 的 访问 过 程 。 

1. 引导 文件 index. php 

引导 文件 位 于 项 目的 public 目录 ,其 代码 如 下 : 


<?php 
// 应 用 路 径 
defined( 'APPLICATION_PATH') 
|| define('APPLICATION_PATH', realpath(dirname( FILE ) . '/../application')); 
// 应 用 环境 
defined('APPLICATION ENV') 
|| define('APPLICATION ENV', (getenv( APPLICATION ENV') ? getenv( 'APPLICATION ENV') : 
'development')); 
// 指 定 工程 包含 目录 
$ paths = array(realpath(APPLICATION PATH . '/../library')); 
if (function exists('zend deployment library path') && zend deployment library path( 'Zend 
Framework 1')) ( 
$ paths[] = zend deployment library path( Zend Framework 1'); 
) 
$ paths[] = get include path(); 
set include path(implode(PATH SEPARATOR, $ paths)); 
// 包 含 application.php 
require once 'Zend/Application. php'; 
// 实 例 化 Zend Application 类 
$ application = new Zend_Application( 
APPLICATION ENV, 
APPLICATION PATH . '/configs/application. ini' 
) 
$ application -> bootstrap() —» run(); // 调 用 启动 类 并 运行 项 目 


在 上 述 代 码 中 ,首先 定义 了 两 个 常量 APPLICATION. PATH 和 APPLICATION_ENV, 分 
别 用 来 保存 应 用 路 径 和 应 用 环境 ,相当 于 两 个 全 局 量 ,它们 在 项 目 中 的 任何 地 方 都 可 以 直接 
使 用 。 然 后 将 项 目的 library 库 文件 目录 和 Zend Framework 类 库 地 址 作为 数组 元 素 保 存 
在 名 为 paths 的 数组 中 ,并 使 用 implodeO PR CIE RMH PATH. SEPARATOR 常量 连 
接 。 最 后 使 用 set_include_path() 方 法 将 路 径 导 入 到 项 目 中 ,这 样 在 项 目 中 就 可 以 直接 找到 
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这 些 路 径 下 的 文件 了 。 

Zend Framework 类 库 被 导入 到 项 目 中 之 后 , 紧 接着 使 用 require once 文件 包含 语句 包 
含 Zend 目录 下 的 Application. php 文件 ,之 后 实例 化 Zend_Application 类 ,并 通过 引用 该 类 
的 bootstrap() 方 法 调用 启动 类 ,最 后 通过 调用 run() 方 法 运行 项 目 。 

2. 项 目 配置 文件 application. ini 

在 上 述 index. php 引导 文件 的 末尾 实例 化 Zend. Application 类 的 时 候 , 为 类 的 构造 函 
数 传人 了 一 个 名 为 application. ini 的 文件 ,该 文件 即 为 工程 的 配置 文件 ,默认 位 于 application\ 
configs 目录 下 。 

打开 该 配置 文件 ,其 内 容 如 下 : 


[production] 


phpSettings.display startup errors = 0 

phpSettings.display errors - 0 

includePaths.library = APPLICATION PATH "/../library" 

bootstrap. path = APPLICATION PATH "/Bootstrap. php" 

bootstrap.class = "Bootstrap" 

appnanespace = "Application" 

resources. frontController.controllerDirectory = APPLICATION PATH "/controllers" 
resources. frontController. params. displayExceptions = 0 


[staging : production] 


[testing : production] 
phpSettings.display startup errors- 1 
phpSettings.display errors = 1 


[development : production] 

phpSettings.display startup errors- 1 

phpSettings.display errors = 1 

resources. frontController. params. displayExceptions = 1 

配置 文件 的 存放 位 置 和 名 称 并 不 固定 ,只 要 与 引导 文件 index. php 中 实例 化 Zend 
Application 类 时 传递 的 参数 一 致 即 可 。 但 要 注意 ,配置 文件 必须 存放 在 用 户 不 能 访问 到 的 
目录 中 ,因为 文件 中 会 有 系统 的 一 些 重要 信息 ,例如 数据 库 的 登录 用 户 名 及 密码 等 ,以 免 危 
及 系统 安全 。 

上 面 index. php 文件 实例 化 Zend Application 类 时 带 入 的 第 2 个 参数 为 APPLICATION _ 
PATH . '/configs/application. ini',APPLICATION_PATH 定义 为 应 用 目录 , 即 application H 
录 , 所 以 上 面 的 参数 为 application\configs\application. ini. 显然 这 就 是 项 目的 配置 文件 的 
地 址 。 另 外 ,Zend Framework 中 的 配置 文件 也 可 以 采用 其 他 类 型 ,例如 Zend_Config 对 象 
或 数组 ,这 从 如 下 Zend. Application 类 的 构造 方法 的 源 代码 可 以 了 解 到 。 

public function _construct( $ environment, $ options = null) 

{ 
$ this—> environment- (string) $ environment; 
require once '"Zend/Loader/Autoloader.php'; 


$ this ->_autoloader = Zend Loader Autoloader::getInstance(); 
if (null !== $ options) { 
if (is string( $ options)) { 
$ options = $ this—> loadConfig( $ options); 
} elseif ( $ options instanceof Zend Config) ( 
$ options = $ options - > toArray(); 
} elseif (!is_array( $ options)) { 
throw new Zend Application Exception ( 'Invalid options provided; must be 
location of config file,a config object,or an array'); 
) 
$ this -> setOptions( $ options); 


} 


注意 构造 方法 中 的 options 即 为 配置 文件 参数 ,函数 体 中 的 3 处 计 条 件 指 明了 配置 文 
件 的 可 能 类 型 。 

配置 文件 以 小 节 的 形式 组 织 , 小 节 名 称 放置 在 [ ] 中 ,括号 中 小 节 名 称 旁 的 冒号 表示 继 
承 关 系 。 例 如 [development: production] 表 示 一 个 development 小 节 , 它 继承 了 production 
小 节 的 属性 配置 。 也 就 是 说 ,development 小 节 同 时 拥有 自己 特有 的 和 production 小 节 中 
的 所 有 配置 。 这 里 的 production、development 表示 应 用 的 不 同 开发 阶段 。 

可 以 看 出 ,上 面 的 配置 文件 有 production, staging, testing, development 4 个 小 节 , 分 别 
可 为 生产 演示、 测试 .开发 4 种 开发 环境 定义 不 同 的 配置 。production 小 节 中 定义 了 一 些 
基本 的 配置 参数 ,其 含义 见 表 2. 2。 

表 2.2 application. ini 参数 配置 说 明 
Roo 说 明 

是 否 显示 PHP 启动 过 程 中 的 错误 信息 ,0 
为 否 ,1 为 是 
是 否 将 错误 信息 作为 输出 的 一 部 分 显示 
到 屏幕 上 ,0 为 否 ,1 为 是 
includePaths. library 一 APPLICATION_PATH "/../library" | 声明 library 路 径 
bootstrap. path= APPLICATION PATH "/Bootstrap. php" | 声明 启动 文件 Bootstrap. php 


phpSettings. display_startup_errors 一 0 


phpSettings. display_errors 一 0 


bootstrap. class= "Bootstrap" 声明 启动 类 名 
appnamespace 一 "Application” 声明 项 目的 命名 空间 为 Application 
resources, frontController. controllerDirectory — APPLICATION 
: ; T -| 定义 前 端 控制 器 路 径 
PATH "/controllers 
resources, frontController. params. displayExceptions— 0 是 否 抛 出 异常 错误 


staging、development 小 节 继 承 了 production 小 节 的 所 有 属性 ,并 且 对 其 中 显示 错误 和 
抛 出 异常 的 配置 进行 了 改写 ,以 使 在 测试 和 开发 过 程 中 能 得 到 详细 的 错误 提示 和 异常 抛 出 
信息 。 

Zend Framework 配置 文件 中 的 所 有 配置 实际 上 是 一 些 全 局 资源 ,也 可 以 自 定义 ,然后 
在 项 目 中 的 其 他 地 方 引 用 。 例 如 ,可 以 在 配置 文件 的 development 小 节 的 最 后 添加 如 下 代 
码 定义 一 个 默认 域名 : 
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default. domain = "http://www. wnstudio. net. cn" 


配置 文件 中 的 配置 项 在 Zend Framework 中 实际 上 是 一 个 注册 表 对 象 的 属性 ,可 以 通 
过 下 面 的 方式 查看 。 
(1) Æ application\ Bootstrap. php 中 添加 注册 对 象 的 初始 化 方法 。 
class Bootstrap extends Zend Application Bootstrap Bootstrap 
{ 
protected function _initRegister () 
{ 
// 配 置 文件 
$ config= $ this -> getOptions(); // 得 到 配置 文件 中 的 配置 项 
Zend Registry::set('config', $ config); // 设 置 注册 表 对 象 


(2) 在 IndexController 控制 器 中 添加 代码 ,输出 配置 项 与 自 定义 域名 。 


class IndexController extends Zend Controller Action 


{ 
public function init() 
{ 


) 
public function indexAction() 
{ 


$ config = Zend Registry: :get( 'config'); // 得 到 注册 表 对 象 

echo $ config[ 'default'][ 'domain']; // 在 视图 中 显示 自 定义 域名 
echo "< pre2"; 

print r( $ config); // 输 出 注册 表 对 象 

echo "</pre>"; 

exit(); 


) 


启动 Apache 服务 器 ,在 浏览 器 地 址 栏 中 输入 http: //wmoams. com, 得 到 如 图 2. 14 所 
示 的 页 面 。 

从 图 2. 14 显示 的 结构 可 以 看 出 ,由 配置 文件 生成 的 注册 表 对 象 确实 是 以 数组 的 形式 保 
存 的 。 所 以 ,可 以 直接 通过 $ config[ 'default']['domain'] 的 形式 引用 配置 文件 的 配置 项 。 
图 中 第 一 行 输出 的 便 是 我 们 自 定义 的 域名 文本 。 

3. 局 动 文件 Bootstrap. php 

在 上 面 的 演示 中 ,我 们 使 用 了 启动 文件 Bootstrap. php, 它 是 应 用 程序 的 启动 类 
Bootstrap 的 定义 文件 。 从 文件 内 容 可 以 看 出 ,启动 类 Bootstrap 继承 于 Zend. Application - 
Bootstrap_Bootstrap 类 ,该 基 类 已 经 实现 了 最 基本 的 启动 配置 工作 ,所 以 在 启动 类 中 不 需 
要 包含 任何 代码 就 可 以 运行 最 基本 的 Zend Framework 应 用 程序 。 

继续 跟踪 Zend_Application_Bootstrap_Bootstrap 类 的 定义 ,就 可 以 弄 清 楚 2. 3 节 中 介 
绍 的 Zend Framework 的 运行 原理 。 


Ce 
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http://www. wmstadio net cn 
Array 
: [phpSettings] => Array 
i [display_startup_errors] => 0 
[display_errors] => 0 
) 


[includePaths] => Array 


[library] => D: WxamppVhtdocsVWwmProjectVapplication/../library 
) 


[bootstrap] => Array 
( 


[path] => D: WxamppYhtdocsWwmProjectVapplication/Bootstrap.php 
[class] => Bootstrap 
) 


[appnamespace] => Application 
[resources] => Array 
n 


图 2.14 配置 对 象 显示 效果 


4. 应 用 程序 文件 Application. php 

1) 动态 加 载 

在 分 析 配置 文件 application. ini 时 ,打开 了 Zend_Application 类 的 构造 方法 ,其 中 有 这 
样 的 语句 : 


require once 'Zend/Loader/hutoloader. php'; 


这 里 包含 的 就 是 Zend Framework 的 动态 加 载 组 件 的 类 文件 。 所 谓 动态 加 载 ,就 是 把 
一 个 PHP 文件 或 类 通过 特殊 的 语句 加 载 到 其 他 文件 中 ,通过 动态 加 载 可 以 实现 PHP 语句 
的 “一 处 定义 、 多 处 使 用 ”。Zend Framework 中 包含 大 量 的 文件 和 类 ,在 使 用 这 些 文件 和 类 
的 时 候 都 是 通过 动态 的 方式 加 载 的 。 

我 们 知道 ,PHP 中 文件 的 加 载 是 通过 include() 或 require() 等 函数 实现 的 ,在 使 用 这 些 
函数 时 所 带 的 参数 必须 是 确定 的 文件 名 或 字符 串 ,而 动态 加 载 可 以 用 变量 作为 参数 。 下 面 
的 代码 实现 了 项 目 docs 目录 中 readme. txt 文件 的 加 载 ,注意 文件 是 通过 filename 变量 输 
人 参数 的 。 


public function indexAction() 
{ 


$ filename = APPLICATION_PATH. '/../docs/readme. txt'; 
Zend_Loader: :loadFile( $ filename); 


} 
在 浏览 器 地 址 栏 中 输入 http://wmoams. com 后 的 页 面 效果 如 图 2.15 所 示 。 
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drum |h Bir pane Ense: 
dB httpi//umoams.com/ L1 


README === This directory should be used to place project specfic documentation including but not limited to project 

|| notes. generated APU/phpdoc documentation, or manual files generated or hand written. Ideally, this directory would remain in 
your development environment only and should not be deployed with your application to it's final production location. Setting Up 
Your VHOST 一 The following is a sample VHOST you might want to consider for your project. 
DocumentRoot "D/xampp/htdocs/wmProject/public" ServerName local # This should be omitted in the production environment 
SetEnv APPLICATION ENV development Options Indexes MultiViews FollowSymLinks AllowOverride All Order 
allow, deny Allow from all 


图 2.15 动态 加 载 文件 效果 


2) 类 Zend_Application 方法 
Zend_Application 类 是 应 用 程序 类 ,用 于 完成 应 用 程序 的 一 系列 初始 化 工作 。 这 些 工 
作 大 部 分 是 通过 _loadConfig() 方 法 加 载 配置 文件 实现 的 ,打开 该 方法 ,可 以 看 到 如 下 源 代 码 : 


protected function _loadConfig( $ file) 
( 
$ environment = $ this 一 > getEnvironment(); 
$ suffix- pathinfo( $ file, PATHINFO EXTENSION); 
$ suffix- ( $ suffix--- 'dist') ? pathinfo( 
basename( $ file,". $ suffix"),PATHINFO EXTENSION) : $ suffix; 
Switch (strtolower( $ suffix)) { 
case 'ini': 
$ config = new Zend Config Ini( $ file, $ environment); 
break; 
case 'xml': 
$ config = new Zend Config Xml( $ file, $ environment); 
break; 
case 'json': 
$ config = new Zend Config Json( $ file, $ environment); 
break; 
case 'yaml': 
case 'yml': 
$ config = new Zend Config Yanml( $ file, $ environment); 
break; 
case 'php': 
case 'inc': 
$ config- include $ file; 
if (!is array( $ config)) { 
throw new Zend Application Exception( 
'Invalid configuration file provided; PHP file does not return array value'); 


) 


return $ config; 
break; 
default: 
throw new Zend Application Exception( 
'Invalid configuration file provided; unknown config type'); 
) 
return $ config - » toArray(); 


} 


从 代码 中 的 switch…case 结构 的 case 匹配 项 可 以 看 出 ,Zend Framework 中 的 配置 文 
件 可 以 是 不 同 的 文件 类 型 ,例如 INI、XML、JSON、PHP 等 ,Zend Framework 会 根据 不 同 的 
类 型 选用 Zend. Config 组 件 中 的 不 同 对 象 对 它 进 行 读 取 ,并 以 数组 的 形式 返回 。 


2.5 本 章 小 结 


本 章 详细 介绍 了 Zend Framework 应 用 的 创建 方法 .目录 结构 .访问 流程 以 及 几 个 重要 
的 框架 文件 的 功能 ,并 对 其 核心 的 前 端 控制 技术 进行 了 简要 说 明 。 前 端 控制 器 的 工作 原理 
比较 复杂 ,大 家 可 以 先 大 致 了 解 一 下 ,这 样 做 并 不 会 影响 后 续 的 学 习 。 

本 章 内 容 是 Zend Framework 应 用 开发 的 基础 ,读者 应 重点 掌握 Zend Framework 框架 
的 MVC 机制, 了解 模型 ,视图 和 控制 器 三 者 的 关系 ,以 及 它们 如 何 相互 配合 ,从 而 实现 各 种 
业务 逻辑 和 数据 显示 的 协同 本 质 。 
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办 公 自 动 化 系统 (Office Automation System,OAS) 是 利用 技术 的 手段 提高 办 公 效 率 ， 
进而 实现 办 公 自 动 化 处 理 的 信息 系统 。 它 采用 Internet/Intranet 技术 ,基于 工作 流 的 概念 ， 
使 企业 内 部 人 员 方 便 、 快 捷 地 共享 信息 ,高 效 地 协同 工作 。OAS 的 使 用 改变 了 企业 过 去 复 
杂 、 低 效 的 手工 办 公 方 式 , 实 现 迅 速 全 方位 的 信息 采集 、 信 息 处 理 , 从 而 实现 企业 管理 的 信 
息 化 与 自动 化 。 

从 本 章 开始 ,我 们 将 以 一 个 办 公 自 动 化 信息 管理 系统 为 例 详细 讲解 Zend Framework 
项 目的 开发 流程 ,以 求 在 最 短 的 时 间 内 让 大 家 轻松 掌握 Zend Framework 的 基本 结构 .规范 
以 及 常用 组 件 的 使 用 方法 ,进而 能 快速 .稳健 地 开发 出 满意 的 Web 应 用 程序 。 


3.1 系统 分 析 


在 开发 一 个 项 目 之 前 ,首先 要 对 所 开发 的 项 目 进行 需求 分 析 、 可 行 性 分 析 , 并 编制 项 目 
计划 书 , 以 使 项 目 开发 人 员 了 解 和 掌握 系统 的 前 期 策划 与 开发 流程 。 


3.1.1 需求 分 析 


本 系统 针对 某 高 等 学 校 所 属 的 一 所 独立 学 院 ,其 具体 情况 如 下 : 

(1) 学 院 是 经 国家 教育 部 批准 设立 的 实施 全 日 制 高 等 学 历 教育 的 普通 高 等 学 校 , 设 有 
24 个 本 科 专 业 、17 个 专科 专业 ,40 余 个 专业 方向 ,覆盖 文 、 理工 \ 农 经. 管 .法 七 大 学 科 门 
类 ,共有 教 职 工 一 千 余 人 、 各 类 在 校 学 生 15 000 多 人 。 

(2) 学 院 经 过 十 多 年 的 发 展 已 经 相对 稳定 ,管理 也 比较 规范 。 原 有 的 办 公 系 统 融 于 教 
务 管理 系统 中 ,功能 相对 简单 , 现 需要 将 其 从 原 有 系统 中 剥离 ,并 增强 其 功能 。 

(3) 学 院 要 求 新 的 OAMS 主要 面向 行政 办 公 人 员 ,教师 的 教务 管理 不 列 于 其 中 。 

(4) 学 院 的 所 有 计算 机 属于 局 域内 网 ,系统 主要 在 内 网 运行 。 学 院 教 职 工 也 可 以 从 学 
校 首 页 的 OAMS 入 口 ,使 用 外 网 进行 登录 ,但 不 保证 网 速 。 

O 学 院 设 有 学 校 办 公 室 、 人 事 处 、 教 务 处 、 宣 传 部 、 网 络 中心 .后勤 服务 中 心 等 职能 部 
门 , 各 系 部 设 有 系 部 办 公 室 、 学 生 工 作 处 等 部 门 。 学 校 和 各 系 部 都 不 排除 增加 其 他 部 门 的 
可 能 。 

(6) 学 院 管理 严格 ,所 有 工作 必须 按 计 划 完 成 .文件 的 收发 .信息 发 布 的 时 间 、 部 门 、 责 
任 人 都 必须 非常 清楚 。 

CD) 学 院 要 求 内 部 文件 及 信息 分 级 别管 理 , 不 同 权限 的 人 员 浏 览 不 同 级 别 的 信息 。 

(8) 学 院 要 求 在 新 的 OAMS 中 能 查询 到 学 校 主要 的 新 闻 及 图 书馆 的 最 新 信息 。 


3.1.2 可 行 性 分 析 


可 行 性 分 析 是 目前 普遍 采用 的 一 种 研究 工程 项 目 是 否 可 行 的 科学 技术 ,其 通过 各 种 有 
效 的 方法 对 工程 项 目 进行 分 析 , 从 技术 经济. 市 场 等 方面 加 以 评价 ,最 终 给 投资 决策 者 提供 
是 否 选择 该 项 目 进行 开发 的 依据 。 

根据 (GB/T 8567—2006 计算 机 软件 文档 编制 规范 》 中 可 行 性 分 析 的 要 求 制定 本 系统 
项 目的 可 行 性 研究 报告 ,简要 说 明 如 下 。 

1. 引言 

1) 编写 目的 

为 了 给 企业 的 决策 层 提供 是 否 进行 项 目 实施 的 参考 依据 , 现 以 文件 的 形式 分 析 项 目的 
风险 、 项 目 需要 的 投资 与 效益 。 

2) 背景 

XX 大 学 XX 学 院 是 经 国家 教育 部 批准 设立 的 实施 全 日 制 高 等 学 历 教育 的 普通 高 等 学 
校 。 学 校 为 了 提高 行政 管理 效率 ,实现 办 公 自 动 化 , 现 需要 委托 其 他 公司 开发 一 个 信息 管理 
系统 ,项 目 名 称 为 XX 办 公 自 动 化 管理 系统 。 

2. 可 行 性 研究 的 前 提 

1) 要 求 

XX 办 公 自 动 化 管理 系统 要 求 能 够 提供 高 等 学 校 日 常 行政 管理 的 功能 ,包括 公文 、 事 
务 、 消 息 等 的 发 布 .接收 \ 回 复 、 查 询 , 并 对 各 类 信息 进行 审核 删除、 检索 等 管理 。 同 时 ,要 求 
系统 能 够 提供 用 户 网 络 空间 .日 程 安排 .工作 日 志 等 办 公 功 能 。 

2) 目标 

XX 办 公 自 动 化 管理 系统 的 主要 目标 是 提供 方便 的 日 常 办 公信 息 发 布 功能 ,快捷 的 信 
息 检 索 功能 以 及 信息 审核 .删除 等 管理 功能 。 

3) AKTE ,假定 和 限制 

项 目 需 要 在 两 个 月 内 交付 用 户 使 用 。 系 统 分 析 师 需要 在 两 天 内 到 位 ,用 户 需要 在 4 天 
内 确认 需求 分 析 文 档 。 去 除 员工 两 个 月 的 正常 休息 日 16 天 ,那么 程序 开发 人 员 需 要 用 一 个 
月 零 几 天 的 时 间 进 行 系统 设计 ,程序 编码 、 系 统 测试 程序 调试 和 系统 部 署 工 作 。 

4) 评价 尺度 

根据 用 户 的 要 求 , 系 统 应 以 发 布 . 检 索 功 能 为 主 ,对 于 所 有 信息 应 能 及 时 准确 地 保存 、 审 
核查 询 、 备 份 。 由 于 系统 需要 在 学 校 各 部 门 运行 ,系统 应 具有 优良 的 局 域 网 操作 能 力 ,系统 
中 各 项 操作 的 延 时 不 能 超过 5 秒 钟 。 此 外 ,在 系统 出 现 故 障 时 ,应 能 及 时 进行 恢复 。 

3. 技术 可 行 性 分 析 

XX 办 公 自 动 化 管理 系统 的 开发 采用 Apache; PHP, Zend Framework, phpMyadmin, 
MySQL 实现 ,这 些 开发 软件 都 是 免费 的 ,可 以 直接 从 网 上 下 载 ,无 须 支 付 任何 费用 。 该 系 
统 的 业务 逻辑 相对 比较 简单 ,并 且 公 司 有 类 似 项 目的 开发 经 验 , 技 术 上 不 存在 任何 阻碍 。 

4. 投资 及 效益 分 析 

1) 支出 

根据 系统 的 规模 及 两 个 月 的 项 目 开 发 周期 ,公司 决定 投入 5 个人。 因此 ,公司 将 直接 支付 
X 万 元 的 工资 及 各 种 福利 待遇 。 在 项 目 安装 及 调试 阶段 ,用 户 培训 、 员 工 出 差 等 费用 支出 需要 


系统 碾 述 及 总 余 讼 计 
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X 万 元 。 在 项 目 维护 阶段 预计 需要 投入 X 万 元 的 资金 ,累计 项 目 投入 需要 XX 万 元 的 资金 。 

2) 收益 

用 户 提供 项 目 资金 XX 万 元 。 对 于 项 目 运行 后 进行 的 改动 ,采取 协商 的 原则 根据 改动 
规模 额外 提供 资金 。 因 此 ,从 投资 与 收益 的 效益 比 上 公司 可 以 获得 XX 万 元 的 利润 。 

项 目 完成 后 ,将 给 公司 提供 资源 储备 ,包括 技术 、 经 验 的 积累 ,以 后 再 开发 类 似 的 项 目 时 
可 以 极 大 地 缩短 项 目 开 发 周期 。 

5. 结论 

根据 上 面 的 分 析 ,技术 上 不 会 存在 问题 ,因此 项 目 延 期 的 可 能 性 很 小 。 在 效益 上 ,公司 
投入 5 个 人 ,两 个 月 的 时 间 获 利 XX 万 元 ,比较 可 观 。 在 公司 今后 的 发 展 上 可 以 储备 办 公 自 
动 化 系统 开发 的 经 验 和 资源 ,因此 认为 该 项 目 可 以 开发 。 


3.1.3 编写 项 目 计划 书 


根据 (GB/T 8567—2006 计算 机 软件 文档 编制 规范 》 中 的 项 目 开 发 计划 要 求 制定 本 系 
统 项 目 设计 的 项 目 计 划 书 ,简要 说 明 如 下 。 

1. 3] 

1) 编写 目的 

为 了 保证 项 目 开发 人 员 按 时 、 保 质地 完成 预订 目标 ,更 好 地 了 解 项 目 实际 情况 ,按照 合 
理 的 顺序 开展 工作 , 现 以 书面 的 形式 将 项 目 开 发 周期 中 的 项 目 任 务 范围 ,项目 团 队 组 织 结 
构 、 团 队 成 员 的 工作 责任 .团队 内 外 沟通 的 协作 方式 、 开 发 进度 、 检 查 项 目 工 作 等 内 容 描 述 出 
来 ,作为 项 目 相 关 人 员 之 间 的 共识 和 约定 以 及 项 目 周期 内 的 所 有 项 目 活动 的 行动 基础 。 

2) 背景 

XX 办 公 自 动 化 管理 系统 是 本 公司 与 XX 大 学 XX 学 院 签 订 的 待 开 发 Web 项 目 ,系统 
性 质 为 日 常 行政 管理 信息 服务 类 型 ,可 为 学 校 各 部 门 及 全 体 教职员 工 提 供 日 常 办 公信 息 的 
发 布 与 检索 ,是 一 个 综合 信息 的 管理 与 互动 交流 平台 ,项 目 周期 为 两 个 月 。 

2. 概述 

1) 项 目 目标 

项 目 目标 应 当 符合 SMART 原则 (目标 管理 原则 ) ,把 项 目 要 完成 的 工作 用 清晰 的 语言 
描述 出 来 。XX 办 公 自 动 化 管理 系统 的 项 目 目标 如 下 : 

XX 办 公 自 动 化 管理 系统 主要 为 用 户 提供 行政 管理 信息 服务 ,日 常 办 公 中 的 所 有 事务 
都 应 该 包括 在 内 ,例如 会 议 通知 公示 公告 .文件 规定 、 新 闻 资 讯 . 申 请 报告 .工作 安排 等 。 项 
目 运行 后 ,要 实现 能 够 为 用 户 的 工作 带 来 极 大 方便 并 提高 学 校 行 政 管理 效率 的 目标 ,整个 项 
目 需要 在 两 个 月 的 期 限 结 束 后 交 给 客户 验收 并 试 运行 。 

2) 产品 目标 与 范围 

一 方面 ,XX 办 公 自 动 化 管理 系统 能 够 实现 学 校 行政 管理 的 电子 化 、 无 纸 化 ,为 学 校 节 
省 大 量 的 办 公 及 人 力 资源 ,降低 管理 成 本 ; 另 一 方面 .XX 办 公 自 动 化 管理 系统 为 学 校 提供 
公共 信息 交互 平台 ,能 大 大 提高 信息 传递 的 快速 性 \ 准 确 性 、 及 时 性 ,提高 管理 效率 。 

3) 应 交付 成 果 

项 目 开 发 完成 后 ,应 交付 的 成 果 内 容 如 下 : 

(1) 以 光盘 的 形式 交付 XX 办 公 自 动 化 管理 系统 的 源 程序 、 系 统 数 据 库 文件 、 系 统 使 用 


说 明 书 。 

(2) 客户 方 拥有 自己 的 服务 器 及 官方 主页 ,需要 乙方 协助 甲 方 在 其 主页 的 适当 位 置 添 
加 “办 公 系 统 ” 登 录 接口 。 

(3) 系统 发 布 到 校园 网 上 以 后 ,提供 为 期 6 个 月 的 无 偿 维护 与 服务 ,超过 6 个 月 后 进行 
系统 有 偿 维护 与 服务 。 

(4) 项 目 验 收 方式 与 依据 

项 目 验 收 分 为 内 部 验收 和 外 部 验收 两 种 方式 。 在 项 目 开发 完成 后 ,首先 进行 内 部 验收 ， 
由 系统 测试 员 根据 用 户 需求 和 项 目 目标 进行 验收 。 项 目 在 通过 内 部 验收 后 交 给 用 户 进 行 验 
收 , 验 收 的 主要 依据 为 项 目 需求 说 明 书 及 相关 规范 。 

3. 项 目 团队 组 织 

1) 组 织 结构 

为 了 完成 XX 办 公 自 动 化 管理 系统 项 目的 开发 ,公司 组 建 了 一 个 临时 的 项 目 团队 ,由 项 
目 经 理 、 系 统 分 析 师 .PHP 开发 工程 师 、 网 页 设计 师 和 系统 测试 员 组 成 。 

2) 人 员 分 工 

为 了 明确 项 目 团队 中 每 个 人 的 任务 分 工 , 现 制定 人 员 分 工 表 ,如 表 3. 1 所 示 。 


表 3.1 项 目 开 发 人 员 分 工 表 


姓名 技术 水 平 所 属 部 站 角色 工作 描述 

负责 项 目的 审批 .决策 的 实施 .项 目的 前 
王 一 浙 pa esa 项 目 开发 部 | 项 目 经 理 | 期 分 析 和 策划 、 项 目 开发 进度 的 跟踪 、 项 

i 目 质量 的 检查 

李晓峰 | 高 级 系统 分 析 师 。” ”| 项 目 开发 部 | 系统 分 析 师 ”| 负责 系统 功能 分 析 ,系统 框架 设计 
郑 加 清 | 高 级 工程 师 项 目 开发 部 pe 开 发 工 | 负责 软件 前 、 后 台 设计 与 编码 
王 秀 芳 | 高 级 美工 设计 师 | 设计 部 网 页 设计 师 ”| 负责 网 页 风格 的 确定 .网 页 图 片 的 设计 
顾 向 荣 | 高 级 系统 测试 工程 师 | 项目 开发 部 | 系统 测试 员 ”| 对 软件 进行 测试 .编写 软件 测试 文档 


3.2 系统 设计 


3.2.1 系统 目标 


本 系统 是 针对 高 等 学 校内 部 自动 化 管理 的 要 求 设计 的 ,主要 实现 如 下 目标 : 
。 键 盘 操 作 , 快 速 响应 ; 

。 实 现 文 件 类 信息 的 强大 管理 能 力 ; 

。 实现 对 教 职 工 基 础 信息 的 管理 功能 ; 

。 实 现 个 人 办 公 的 信息 自动 化 管理 功能 ; 

。 实 现 个 人 办 公 的 即时 信息 收发 功能 ; 

。 实 现 个 人 办 公 的 用 户 网 络 空间 功能 ; 

。 对 系统 用 户 进行 管理 ,包括 访问 权限 控制 ; 

。 实现 数据 备份 .系统 日 志 功能 ; 
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系统 功能 结构 
下 面 根据 系统 分 析 及 系统 目标 给 出 系统 的 前 、 后 台 管 理 功能 结构 图 ,如 图 3. 1 和 图 3. 2 


。 系统 最 大 限度 地 实现 易 安装 性 、 易 维护 性 和 易 操 作 性 ; 
。 系统 运行 稳定 、 安 全 可 靠 。 
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图 3.2 后 台 管 理 的 功能 结构 
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3.2.3 系统 功能 预览 


系统 前 、 后 台 管 理 功能 分 别 由 Zend Framework 的 默认 模块 及 自 定义 admin 模块 实现 ， 
图 3.1 和 图 3. 2 中 的 各 个 功能 单元 分 别 对 应 模块 中 的 不 同 控制 器 ,而 功能 单元 中 的 每 项 具 
体 功 能 , 则 由 控制 器 的 方法 完成 。 

下 面 仅 列 出 几 个 典型 页 面 ,其 他 页 面 请 参考 源 代码 或 后 续 章 节 。 

l. 前 人 台 登 录 页 面 

图 3.3 所 示 为 系统 前 台 登 录 页 面 ,该 页 面 用 于 实现 对 用 户 登录 的 信息 验证 。 由 于 本 系 
统 为 学 校内 部 使 用 系统 ,用 户 必须 通过 登录 认证 后 才能 进入 系统 内 部 页 面 。 用 户 注册 由 系 
统管 理 员 统一 操作 完成 ,不 允许 用 户 自行 注册 。 为 方便 用 户 找 回 密码 ,在 页 面 中 设置 了 “ 忘 
记 密 码 ” 超 级 链接 。 


微 梦 软件 - 登录 
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2. 前 台 主 页 

图 3. 4 所 示 为 系统 前 台 主 页 页 面 , 该 页 面 上 显示 了 导航 菜单 ,登录 用 户 的 姓名 .所属 部 
门 及 角色 等 信息 ,用 户 可 以 单 击 姓名 进入 个 人 信息 页 面 对 个 人 信息 进行 修改 。 除 此 之 外 ,页 
面 上 还 设置 了 “通知 公告 "“ 最 新 公文 “个 人 日 程 "“ 最 新 消息 ”“ 待 办 提醒 ”以 及 “工作 安 
排 ” 等 重要 信息 的 显示 区 域 ,方便 用 户 快速 ,准确 地 了 解 需 要 处 理 的 工作 事务 。 

3. 公文 管理 

图 3.5 所 示 为 系统 公文 信息 管理 模块 主页 面 , 该 页 面 按 公文 类 型 分 类 显示 与 用 户 及 用 
户 所 在 部 门 有 关 的 文件 信息 ,用 户 单 击 文件 标题 即 可 进入 详细 内 容 页 面 。 

4. 留言 管理 

图 3. 6 所 示 为 系统 留言 信息 管理 模块 主页 面 , 系 统 留言 信息 模块 是 用 户 个 人 消息 收发 
平台 ,有 利于 用 户 工作 时 的 及 时 沟通 。 该 界面 模仿 了 常见 的 邮件 系统 。 
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3.5 系统 公文 信息 管理 


5. 事务 管理 

图 3. 7 所 示 为 系统 事务 信息 管理 模块 主页 面 ,该 模块 用 于 事务 的 添加 以 及 分 类 显示 , 界 
面 借用 了 图 3. 6 的 样式 。 

6. 日 程 管理 

图 3. 8 所 示 为 用 户 日 程 信息 管理 模块 页 面 , 该 模块 用 于 用 户 日 程 事 务 的 添加 以 及 分 类 
显示 ,设置 了 ”今日 工作 >”“ 本 周 安排 >“ 日 程 查 询 ” 与 “ 待 办 提醒 ”等 功能 项 。 图 中 显示 的 是 
用 户 个 人 日 程 查询 界面 ,采用 了 电子 台历 的 方式 ,符合 用 户 的 办 公 习惯 。 
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3.7. 系统 事务 信息 管理 


7. 网 络 空间 

图 3. 9 所 示 为 用 户 网 络 空间 管理 模块 页 面 ,系统 为 用 户 提供 了 一 定 容 量 的 网 络 存储 空 
间 ,以 方便 用 户 日 常 办 公 的 需要 。 在 这 里 用 户 可 以 建立 自己 的 文件 夹 ,还 可 以 上 传 、 下 载 移 
动 文件 , 它 是 一 个 功能 齐全 的 资源 管理 器 。 

8. 管理 中 心 

图 3. 10 所 示 为 系统 后 台 管理 模块 页 面 效 果 , 系 统 后 台 管理 中 心 根据 用 户 角色 或 权限 进 
行 访问 控制 ,不 允许 普通 用 户 进 入 ,部 门 管理 员 也 只 拥有 部 分 页 面 的 访问 权限 。 
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图 3.9 用 户 网 络 空间 管理 页 面 


3.2.4 系统 工作 流程 


用 户 登录 系统 后 会 进行 一 系列 操作 ,把 这 些 操 作 的 过 程 和 结果 以 图 形 的 形式 表现 出 来 ， 
不 仅 可 以 让 开发 者 快速 地 理 清 思路 ,及 时 解决 出 现 的 问题 ,还 可 以 让 使 用 者 很 快 明白 该 系统 
的 操作 方式 与 方法 。 下 面 给 出 本 办 公 自 动 化 管理 系统 的 工作 流程 ,如 图 3. 11 Bron. 
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图 3.10 系统 后 台 管 理 中 心 
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图 3.11 系统 工作 流程 图 
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3.2.5 开发 环境 


本 系统 开发 软件 环境 如 下 : 

* 操作 系统 : Windows 7 旗舰 版 

服务 器 : Apache 2.0; 

PHP 软件 : 5.5.11; 

。 数据 库 : MySQL 5.6.16; 

* MySQL 图 形 化 管理 软件 : phpMyAdmin 4. 1.12; 
* 开发 工具 : Zend Studio 10. 6. 1、Notepad++6. 6. 7; 
浏览 器 : IE 8.0; 

分 辩 率 : 最 佳 效果 1366 X768。 


3.3 数据 库 设 计 


系统 开发 离 不 开 数 据 库 的 支持 ,只 有 拥有 了 强大 的 数据 库 才能 存储 大 量 的 数据 信息 , 实 
现 更 多 ,更 好 的 功能 为 用 户 服务 。 本 书 案例 项 目 是 一 个 办 公正 动 化 管理 系统 ,采用 了 数据 表 
对 办 公信 息 进行 存储 。 下 面 对 系 统 数据 库 设计 做 一 个 简单 介绍 。 


3.3.1 数据 库 分 析 


本 系统 是 一 个 中 小 型 办 公信 息 管理 平台 ,考虑 到 开发 成 本 、 搭 配 的 合理 性 以 及 操作 的 灵 
活性 等 ,选用 MySQL 数据 库 。 

MySQL 数据 库 是 目前 最 流行 的 开源 数据 库 , 是 完全 网 络 化 、 跨 平台 的 关系 型 数据 库 系 
统 , 它 是 完全 免费 的 ,可 以 在 网 上 任意 下 载 。 同 时 ,从 匹配 的 角度 来 说 ,PHP 与 MySQL 数 
据 库 一 直 都 是 公认 的 最 佳 搭档 。 另 外 ,MySQL 数据 库 不 仅 可 以 在 命令 模式 下 进行 操作 ,还 
配备 了 一 些 图 形 化 管理 工具 ,例如 phpMyAdmin 等 ,大 大 方便 了 对 数据 库 的 操作 。 


3.3.2 数据 库 概念 设计 


根据 上 述 项 目 需求 分 析 及 系统 功能 将 系统 实体 关系 归纳 为 以 下 几 种 。 

1. 用 户 信息 实体 

用 户 信息 实体 包括 职工 姓名 、 登 录 名 、 密 码 .性别 .年龄 .所 属 部 门 、 角 色 等 表示 个 人 身份 
的 所 有 人 事 数 据 信息 及 系统 使 用 信息 。 为 了 更 清晰 地 表示 存储 数据 的 层次 关系 ,实体 中 还 
包含 了 一 些 依附 数据 的 子 实体 ,例如 部 门 实体 等 。 

2. 公文 信息 实体 

公文 信息 实体 包括 公文 类 型 .发布 人 、 发 布 时 间 ,发 布 部 门 .接收 单位 ,处理 状 态 .密级 等 
相关 信息 ,其 中 还 包含 公文 类 型 等 子 实体 。 

3. 留言 信息 实体 

留言 信息 实体 包括 留言 主题 .留言 内 容 、 信 息 发 布 人 、 信 息 接收 人 、 信 息 发 布 与 接收 时 间 
等 ,包含 用 户 好 友子 实体 。 


4. 事务 信息 实体 

事务 信息 实体 包括 申请 事务 信息 子 实体 与 日 程 安排 信息 子 实体 ,分 别 存储 事务 主题 事 
务 内 容 、 事 务 处 理 时 间 以 及 事务 处 理 状态 等 相关 信息 。 

5. 网 络 空间 信息 实体 

网 络 空间 信息 实体 包括 用 户 网 络 空间 名 称 、 容 量 大 小 、 文 件 名 、 子 目录 名 等 相关 信息 。 


3.3.3 数据 库 物理 结构 设计 


根据 上 述 数 据 库 概 念 设计 ,创建 一 个 名 为 db_wmoams 的 数据 库 , 其 中 包含 13 张 数据 
表 , 如 图 3.12 所 示 。 


[本 服务 器 : 127.0.0.1 » © HEE: db_wmoams 


结构 Lj SQL a 搜索 G 查询 B 导出 图 导入 GJ sfr 


ka 行 数 o 类 型 排序 规则 大 小 多 余 
tb_affair 7 MyISAM gb2312 chinese ci 2.6 KB - 
tb depart 17 MyISAM utf8 general ci 3.7 KB z 
tb_docs 23 MyISAM utf8_general_ci 6.8 KB 1.2KB 
tb_doctype 15 MyISAM utf8 general ci 2.3 KB S 
tb friend 2 MyISAM utf8 general ci 2.1 KB - 
tb news 11 MyISAM utfà, general ci 4.9 KB - 
tb receive ~5 InnoDB  utf8 general ci 16 KB - 
tb reply 1 MyISAM gb2312 chinese ci 2.1 KB - 
tb schedule 2 MyISAM gbk chinese ci 2.1 KB - 
tb send ~7 InnoDB  utf8 general ci 16 KB - 
tb_userfile 3 MyISAM gbk_chinese_ci 4.2 KB 52 字 节 
tb userfolder 5 MyISAM gbk chinese ci 4.2 KB = 
tb_users 46 MyISAM utf8_general_ci 9.3 KB - 
13 张 表 总 计 144 InnoDB latin1_swedish_ci 76.4 KB 1.3 KB 


图 3.12 系统 数据 库 中 的 数据 表 


图 3. 12 中 的 数据 表 从 上 至 下 依次 为 事务 表 、 部 门 表 、 公 文 表 、 公 文 类 型 表 、 好 友 表 、 新 闻 
资讯 表 、 留 言 收 件 表 、 事 务 批示 表 日 程 表 、 留 言 发 件 表 、 用 户 文 件 表 、 用 户 目 录 表 以 及 用 户 信 
息 表 。 为 了 节省 篇 幅 , 将 各 数据 表 的 详细 设计 移 至 后 续 章 节 中 ,这 里 暂 不 介绍 。 


3.4 公共 文件 设计 


公共 文件 就 是 将 系统 中 可 能 在 不 同 的 地 方 被 使 用 多 次 的 代码 编辑 而 成 的 单独 文件 ,在 
使 用 时 只 需要 用 include 或 require 等 语句 将 文件 包含 进来 即 可 。 这 些 文件 一 般 包 括 数据 库 
的 连接 ,分 页 管理 .模板 配置 、 自 定义 类 、CSS 样式 以 及 JS 脚本 等 文件 , 依 系统 设计 模式 
变化 。 

本 系统 采用 Zend Framework 框架 技术 ,与 页 面 视图 有 关 的 公共 代码 将 由 Zend 
Framework 提供 的 “助手 ?技术 实现 ,而 公共 的 业务 逻辑 部 分 由 自 定义 的 公共 控制 器 管理 。 
所 以 ,本 案例 系统 中 的 公共 文件 主要 指 页 面 的 CSS 样式 文件 以 及 JS 脚本 文件 ,对 于 这 部 分 
内 容 请 读者 参考 本 书 源码 。 
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3.5 本 章 小 结 


本 章 针对 案例 项 目 简要 介绍 了 Web 应 用 开发 的 一 般 步骤 ,包括 系统 分 析 、 系 统 设计 等 ， 
旨 在 为 大 家 呈现 一 个 项 目 开 发 的 完整 过 程 。 软 件 作 为 一 种 产品 ,有 其 特有 的 生产 管理 方法 
以 及 应 遵循 的 标准 规范 ,这 些 都 是 大 家 必须 要 了 解 的 。 

本 章 内 容 比 较 简单 ,并 且 不 同 的 企业 \ 不 同 的 项 目 类 型 还 会 存在 很 大 的 差异 ,学习 本 章 
重点 掌握 所 介绍 的 项 目 开发 及 管理 流程 。 


第 4 章 页 面 设 计 及 layout 布局 模板 


对 于 一 个 办 公 自动 化 管理 系统 来 说 ,其 主要 作用 是 帮助 企业 提高 管理 效率 和 办 公 效 率 ， 
因此 系统 页 面 不 可 能 、 也 不 允许 进行 复杂 的 设计 ,每 个 页 面 上 显示 的 内 容 也 不 能 太 多 ,应 做 
到 简洁 大 方 、 重 点 突出 、 导 航 方便 。 

本 章 通 过 系统 首页 .用户 登录 以 及 系统 主页 页 面 的 设计 介绍 系统 页 面 布局 .CSS 样式 
表 等 常用 页 面 设 计 方 法 ,重点 介绍 Zend Framework 中 的 layout 布局 模板 。 


4.1 系统 初始 设置 


通过 第 2 章 的 分 析 ,读者 基本 了 解 了 Zend Framework 应 用 的 项 目 结构 及 运行 机 制 。 
除了 配置 文件 中 的 基本 设置 外 ,在 系统 开发 过 程 中 还 需要 添加 一 些 自己 的 配置 ,例如 页 面 的 
共有 设置 ,注册 表 的 设置 .缓存 的 设置 .认证 的 设置 等 。 


4.1.1 页 面 共 有 属性 设置 


1. 视图 对 象 初始 化 

系统 的 初始 化 一 般 在 应 用 程序 的 启动 类 Bootstrap 中 完成 。 启 动 类 Bootstrap 中 的 初 
始 化 方法 均 以 _init 为 前 级 ,它们 不 是 PHP 内 置 的 ,而 是 由 Zend Framework 框架 开发 者 自 
己 定 义 的 。 框 架 会 在 执行 其 他 程序 之 前 执行 这 些 方法 ,这 实际 上 和 PHP. 内置 的 构造 函数 
construct 类 似 ,不 同 之 处 在 于 构造 函数 是 PHP 内 置 的 ,由 了 PHP 解析 引擎 自动 调用 , 它 处 
于 请 言 级 ; 而 初始 化 方法 是 由 PHP 框架 自动 调用 的 ,处 于 框架 级 ,因此 后 者 比 前 者 使 用 起 
来 更 加 灵活 。 

打开 启动 文件 application\ Bootstrap. php, ÆÆ Bootstrap 中 添加 一 个 名 为 _initView 
的 初始 化 方法 ,并 实例 化 一 个 视图 对 象 ,代码 如 下 : 


class Bootstrap extends Zend Application Bootstrap Bootstrap 
( 
protected function initView()í 
$ view- new Zend View(); 
return $ view; 
) 
) 


上 述 代码 中 的 类 Zend View 是 Zend Framework 用 来 处 理 MVC 模式 中 视图 功能 的 
类 ,使 用 它 可 以 将 视图 部 分 的 代码 与 模型 及 控制 器 部 分 的 代码 进行 分 离 。 这 里 直接 采用 
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new 方法 创建 视图 对 象 ,这 个 视图 对 象 将 成 为 我 们 项 目的 视图 。 大 家 可 能 会 觉得 奇怪 ,在 第 
2 章 中 ,我 们 已 经 成 功 运行 了 项 目 , 但 那 时 并 没有 定义 视图 对 象 ,为 什么 也 能 显示 视图 页 面 
呢 ? 其 实 , 在 Zend Framework 框架 的 每 个 控制 器 中 都 有 一 个 initView 方法 ,通过 这 个 方 
法 ,控制 器 能 获得 已 经 存在 的 视图 对 象 ,一 旦 检测 到 视图 对 象 不 存在 , 则 会 创建 它 。 该 初始 
化 方法 是 Zend_Controller_Action 类 的 一 个 成 员 函 数 , 大 家 可 以 打开 Zend Framework 库 中 
的 Zend\Controller\Action. php 文件, 看 一 下 里 面 的 源 代码 。 

2. 配置 页 面 资源 

在 配置 文件 application\configs\application. ini 的 development 小 节 添 加 如 下 配置 代 
码 ,设置 系统 页 面 的 一 些 共 有 属性 。 


pageInfo.default.doctype = "XHTML1 STRICT" 
pageInfo. default. title = " 微 梦 办 公 自 动 化 管理 系统 " 


上 述 代 码 的 第 1 名 设置 系 统 页 面 的 文档 类 型 ; 第 2 句 设置 系统 默认 模块 的 视图 页 面 标 
题 。 视 图 页 面 的 文档 类 型 主要 包括 XHTML, XHTML STRICT,XHTMLI | TRANSITIONAL, 
XHTML1 FRAMESET, XHTML1 BASICI, HTML4 STRICT, HTML4 _ LOOSE, 
HTML4_ FRAMESET 等 。 

3. 添加 页 面 类 型 

本 系统 视图 页 面 采用 XHML 格式 ,在 视图 对 象 中 添加 页 面 类 型 XHTML_STRICT。 

class Bootstrap extends Zend Application Bootstrap Bootstrap 

md function initView()( 

$ pageInfo- $ this - > getOption( pageInfo'); 
$ view = new Zend View(); 


$ view —> doctype( $ pageInfo[ 'default'][ 'doctype']); 
return $ view; 


) 


首先 获取 配置 文件 中 的 pageInfo 资源 ,然后 以 参数 的 方式 将 doctype 的 值 传 入 视图 对 
Sup, 设置 HTML 页 面 中 的 文档 类 型 (DOCTYPE) 属 性 为 XHTML1_STRICT, 即 相当 于 
在 页 面 中 添加 了 如 下 标签 内 容 。 


<! DOCTYPE html PUBLIC " — //W3C//DTD XHTML 1. 0 Strict//EN" 
"http://www. w3. org/ TR/xhtm11/DTD/xhtmll - strict. dtd"> 


4. 添加 页 面 标题 
本 系统 的 所 有 视图 页 面 标题 都 设置 为 " 微 梦 办 公 自 动 化 管理 系统 ”, 通 过 参数 的 方式 向 
视图 中 添加 。 


class Bootstrap extends Zend Application Bootstrap Bootstrap 
{ 
protected function _initView(){ 
$ pageInfo- $ this -> getOption( 'pageInfo'); 
$ view = new Zend View(); 
$ view- » doctype( $ pageInfo[ 'default'][ 'doctype']); 


$ view 一 > headTitle( $ pageInfo[ 'default'][ 'title']); 
return $ view; 
} 
} 
上 面 的 阴影 部 分 代码 设置 视图 页 面 中 的 标题 (title) 值 为 “ 微 梦 办 公 自 动 化 管理 系统 ”， 
即 相当 于 在 页 面 中 添加 了 如 下 标签 内 容 : 


<title> 微 梦 办 公 自动 化 管理 系统 </title> 


为 了 能 够 尽 可 能 多 地 介绍 Zend Framework 的 组 件 功 能 ,这 里 采用 了 通过 配置 文件 设 
置 视 图 页 面 属性 的 方法 。 上 述 代码 中 使 用 的 getOption 方法 是 Zend_ Application _ 
Bootstrap_Bootstrap 类 的 基 类 Zend_Application_Bootstrap_BootstrapAbstract [1] JX, 51 PK 
数 ; 而 代码 中 的 doctype 和 headTitle 看 起 来 好 像 是 Zend_View 类 的 成 员 函 数 ,但 在 视图 类 
Zend_View 及 其 基 类 Zend_View_Abstract 中 却 找 不 到 它们 。 其 实 , 它 们 是 Zend Framework 的 
视图 助手 ,关于 “助手 ”的 概念 ,我 们 将 在 第 11.12 章 中 详细 介绍 ,大 家 暂且 把 它们 当 作 方法 
使 用 即 可 。 

注意 ,这 里 只 是 在 视图 对 象 中 设置 了 “文档 类 型 "与 “页 面 标题 ”", 如 果 要 在 视图 页 面 中 使 
用 它们 ,还 必须 在 页 面 中 用 PHP 的 echo 进行 输出 。 


4.1.2 对 象 注册 表 设 置 


1. 添加 注册 初始 化 方法 
为 了 在 系统 的 其 他 地 方 使 用 application. ini 中 的 自 定义 配置 项 ,在 Bootstrap 类 中 再 添 
加 一 个 _initRegister 方法 ,代码 如 下 : 


class Bootstrap extends Zend Application Bootstrap Bootstrap 
{ 


protected function _initRegister() { 


} 
} 


2. 创建 对 象 注册 表 
在 _initRegister 方法 中 实例 化 一 个 Zend_Registry 类 对 象 ,并 将 配置 文件 application. 
ini 中 的 所 有 配置 项 放 入 注册 表 对 象 中 。 


class Bootstrap extends Zend Application Bootstrap Bootstrap 
{ 


protected function initRegister() 
t 
$ config= $ this -> getOptions(); 
Zend_Registry: :set('config', $ config); 
) 
} 
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与 对 象 的 存储 容器 。 将 程序 中 的 值 或 对 象 存储 在 注册 表 中 ,就 可 以 在 程序 中 随时 随地 引用 ， 
也 可 以 把 它 简 单 地 理解 为 一 种 特殊 的 全 局 变量 。 

上 述 代码 中 的 set 方法 是 Zend_Registry 类 的 静态 方法 ,这 里 使 用 这 个 方法 为 注册 表 对 
象 设置 内 容 , 即 将 系统 配置 文件 中 的 配置 项 全 部 放 入 到 注册 表 对 象 中 。 注 意 ,采用 set 方法 
设置 的 注册 表 内 容 在 使 用 时 需要 用 get 方法 获取 。 当 然 ,也 可 以 采用 传统 的 new 方法 实例 
化 一 个 注册 表 对 象 ,代码 如 下 : 


$ registry = new Zend_Registry(array( 'config' => $ config) 
这 里 返回 的 值 registry 就 是 一 个 对 象 注册 表 实 例 。 
4.1.3 会 话 设置 


在 计算 机 语言 中 ,会 话 是 一 种 面向 连接 的 可 靠 通信 方式 。 在 PHP 中 , 它 代表 服务 器 端 
与 客户 端 之 间 的 一 种 持久 的 状态 数据 。 使 用 Zend Framework 的 Zend. Session 组 件 可 以 在 
由 相同 客户 端 发 起 的 多 个 页 面 请 求 之 间 管 理 和 保护 会 话 数 据 。 

为 了 后 续 项 目 开发 的 需要 ,这 里 先 创建 一 个 名 为 session 的 会 话 空间 。 打 开 Bootstrap. php 
启动 文件 ,继续 添加 代码 : 


class Bootstrap extends Zend Application Bootstrap Bootstrap 
í 


protected function _initRegister () 
{ 


$ session = new Zend Session Namespace( 'session'); 
Zend_Registry: :set('session', $ session); 
} 
} 


4.1.4 缓存 设置 


缓存 是 Web 应 用 中 几乎 都 要 用 到 的 性 能 优化 技术 方案 ,使 用 缓存 可 以 极 大 地 减轻 服务 
器 的 负载 。 关 于 缓存 的 原理 及 使 用 ,我 们 将 在 第 12 章 中 进行 详细 介绍 。 

首先 在 配置 文件 applicationNconfigsVapplication. ini 中 设置 缓存 参数 ,包括 失效 时 间 与 
存储 路 径 。 打 开 配 置 文件 ,在 development 小 节 中 添加 如 下 代码 : 


cache. leftTime = "3600" 
cache.cache dir = APPLICATION PATH "/cache/" 


这 里 设置 缓存 的 失效 时 间 为 两 个 小 时 ,缓存 数据 存储 目录 为 应 用 目录 下 的 cache 子 目 
录 。 该 子 目 录 需 要 用 户 自己 手工 创建 。 


缓存 的 参数 有 很 多 ,这 里 只 简单 地 配置 了 两 项 。 准 备 好 缓存 参数 后 ,就 可 以 在 初始 化 方 
法 中 创建 缓存 对 象 了 。 代 码 如 下 : 


class Bootstrap extends Zend Application Bootstrap Bootstrap 
{ 


protected function initRegister () 
( 


$ frontOptions = array('leftTime'-» $ config['cache'][ 'leftTime'], 


'automatic serialization'- true); 
$ backOptions = array( 
'cache dir'-» $ config[ 'cache'][ 'cache dir']); 
$ cache = Zend Cache: : factory( 'Core', 'File', $ frontOptions, $ backOptions); 
Zend Registry::set('cache', $ cache); 


} 


4.1.5 认证 对 象 设置 


Zend Framework 提供 了 用 户 访问 认证 功能 ,该 功能 由 Zend. Auth 组 件 实现 。 用 户 的 
认证 信息 影响 了 该 用 户 在 系统 中 的 访问 权限 。 由 于 在 应 用 的 很 多 地 方 都 要 使 用 认证 信息 ， 
所 以 ,我 们 把 它 作 为 一 个 全 局 对 象 来 处 理 。 

在 启动 文件 中 继续 添加 代码 : 


class Bootstrap extends Zend Application Bootstrap Bootstrap 
{ 


protected function _initRegister () 
( 


$ auth = Zend Auth: :getInstance(); 
$ storage = new Zend Auth Storage Session('session', 'user'); 
$ auth - » setStorage( $ storage); 


) 


在 上 述 代 码 中 ,首先 使 用 Zend Framework 的 认证 组 件 Zend. Auth 类 的 静态 方法 获取 
认证 对 象 ,然后 创建 认证 对 象 的 信息 存储 空间 。 


4.2 CSS 样式 表 


本 书 主 要 讲解 Zend Framework 框架 ,重点 介绍 Zend Framework 中 组 件 的 使 用 方法 ， 
因此 ,CSS 样式 文件 并 不 属于 本 书 讲解 的 范围 ,但 作为 一 个 Web 应 用 ,这 项 内 容 又 是 必 不 可 
少 的 ,而 且 在 实际 开发 过 程 中 没有 专职 美工 的 情况 下 ,常常 会 花费 大 量 的 时 间 与 精力 。 

为 了 让 注意 力 集中 于 框架 编程 本 身 , 将 本 书 案例 项 目的 所 有 CSS 样式 文件 存放 在 学 习 
辅导 网 站 ( 微 梦 网 ) 上 ,请 大 家 到 网 站 相关 目录 下 载 , 网 址 为 http://www. wmstudio. net. cn; 

在 后 续 的 项 目 开发 过 程 中 ,为 了 保持 项 目 MVC 模式 中 各 部 分 的 完整 ,并 让 大 家 在 学 习 
过 程 中 能 及 时 看 到 页 面 效 果 , 我 们 对 各 控制 器 的 视图 代码 做 了 说 明 ,但 大 多 非常 简单 。 为 了 
帮助 大 家 更 好 地 理解 后 续 的 页 面 布局 ,下 面 对 CSS 样式 及 相关 背景 做 一 个 简单 介绍 。 
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4.2.1 Web 标准 布局 


虽然 传统 的 网 页 布局 (即使 用 table 的 布局 ) 已 经 有 很 长 的 历史 和 较 成 熟 的 技术 规范 
了 ,但 其 存在 的 缺陷 也 是 非常 明显 的 。 在 这 种 布局 中 ,由 于 页 面 的 内 容 和 修饰 没有 分 离 .页 
面 代码 的 语义 不 明确 ,导致 页 面 升级 与 数据 利用 都 非常 困难 。 

建立 Web 标准 就 是 要 解决 网 站 中 由 于 浏览 器 升级 .网 站 代码 膝 肿 、 代 码 不 易 用 等 带 来 
的 诸多 问题 , 它 由 W3CCWSC. org 万 维 网 联盟 ) 组 织 与 实施 。 

Web 标准 分 为 3 个 方面 , 即 结构 标准 语言 .表现 标准 语言 和 行为 标准 。 

1. 结构 标准 语言 

结构 标准 语言 包括 XML 和 XHTML 两 个 部 分 。XML 是 The Extensible Markup 
Language 的 简写 , 它 是 一 种 扩展 式 标识 语言 。XML 设计 的 目的 是 对 HTML 补充 , 它 具 有 
强大 的 扩展 性 ,可 以 用 于 网 络 数据 的 转换 和 描述 。 同 时 XML 具有 简洁 有 效 ,易学 易 用 、 开 
放 的 国际 化 标准 、 高 效 可 扩充 等 特点 。XHTML 是 The Extensible HyperText Markup 
Language( 可 扩展 标识 语言 ) 的 缩写 ,XHML 是 基于 XML 的 标识 语言 ,是 在 HTML 4. 01 
的 基础 上 用 XML 的 规则 对 其 进行 扩展 建立 起 来 的 , 它 是 HTML 向 XML 的 过 渡 。 

2. 表现 标准 语言 

表现 标准 语言 包括 CSS, 它 是 Cascading Style Sheets( 层 释 样 式 表 ) 的 缩写 。 目 前 推荐 
遵循 的 是 W3C F 1998 年 5 月 12 日 推出 的 CSS2。CSS 标准 建立 的 目的 是 以 CSS 进行 网 
页 布局 ,控制 网 页 的 表现 。CSS 标准 布局 与 XHTML 结构 语言 相 结合 ,可 以 实现 表现 与 结 
构 相 分 离 ,提高 应 用 的 使 用 性 和 可 维护 性 。 

3. 行为 标准 

行为 标准 也 包括 两 个 部 分 , 即 DOM 和 ECMAScript。DOM 是 Document Object Model 
(文档 对 象 模型 ) 的 缩写 。W3C 建立 的 W3C DOM 是 建立 网 页 与 Script 或 程序 语言 沟通 的 
桥梁 , 它 实现 了 访问 页 面 中 标准 组 件 的 一 种 标准 方法 。ECMAScript 是 ECMA (European 
Computer Manufacturers Association) 制 定 的 标准 脚本 语言 。 


4.2.2 Web 标准 的 优势 


使 用 Web 标准 可 以 大 大 缩减 页 面 代码 ,提高 浏览 速度 ,缩减 带宽 成 本 。 由 于 其 结构 清 
晰 ,也 能 使 网 页 更 容易 被 搜索 引擎 搜索 。 因 此 , 它 对 Web 应 用 的 浏览 者 及 拥有 者 都 是 有 
益 的 。 

1. 对 于 Web 应 用 的 浏览 者 

。 页 面 代码 量 减少 ,文件 下 载 速 度 更 快 ,同时 浏览 器 显示 页 面 的 速度 更 快 ; 

。 清晰 的 语义 结构 ,使 得 内 容 能 被 更 多 的 用 户 所 访问 ; 

。 实现 了 结构 和 表现 相 分 离 ,内 容 能 被 更 多 的 设备 (包括 手机 、 打 印 机 等 ) 所 访问 ; 

。 由 于 样式 文件 的 独立 性 ,用 户 选 择 自 己 喜 欢 的 界面 变 得 更 容易 ; 

。 由 于 可 以 调用 独立 的 打印 样式 文件 ,所 以 便于 页 面 的 打印 。 

2. 对 于 Web 应 用 的 拥有 者 

。 代码 变 得 更 简洁 、 组 件 用 得 更 少 , 使 维护 变 得 很 容易 ; 

。 对 带宽 要 求 降低 ,节约 了 成 本 ; 


。 页 面 结 构 的 语义 性 清晰 ,使 搜索 引擎 的 搜索 变 得 更 容易 ; 

”实现 了 结构 和 表现 的 分 离 , 使 得 在 对 页 面 外 观 进行 修改 的 时 候 不 改变 页 面 内 容 ; 
e 可 以 调用 不 同 的 样式 文件 ,使 得 提供 打印 版 本 变 得 更 容易 ; 

。 清晰 合理 的 页 面 结构 ,提高 了 Web 应 用 的 易 用 性 。 


4.2.3 CSS 样式 基础 


JESUS CSS 是 W3C 组 织 制定 的 用 于 控制 网 页 样式 的 一 种 标记 语言 , 它 包 括 
CSS1 和 CSS2 两 部 分 。 其 中 ,CSS2 是 于 1998 4 5 月 发 布 的 ,包含 了 CSS1 的 内 容 , 它 也 是 
现在 通用 的 标准 。 

1. CSS 语法 

通常 情况 下 ,CSS 的 语法 包括 3 个 方面 , 即 选择 符 、 属 性 和 值 。 其 格式 如 下 : 

选择 符 {属性 : 属性 值 ; } 

说 明 : 

。 属性 必须 包含 在 { } 号 之 中 ; 

。 属性 和 属性 值 之 间 用 “ : ?分隔 ; 

。 当 有 多 个 属性 时 ,用 *; ”进行 区 分 ; 

。 在 书写 属性 时 属性 之 间 使 用 空格 .换行 等 不 影响 属性 的 显示 ; 

。 如 果 一 个 属性 有 几 个 值 , 则 每 个 属性 值 之 间 用 空格 分 隔 。 

2. 选择 符 

选择 符 中 常用 的 是 通 配 选 择 符 、 类 型 选择 符 、 包 含 选择 符 、ID 选择 符 、 类 选择 符 和 选择 
符 分 组 。 

1) 通 配 选 择 符 

通 配 选 择 符 的 写法 是 “* ”, 其 含义 就 是 所 有 元 素 。 例 如 : 

* (font - size:12px) 
表示 页 面 中 所 有 文本 的 字体 大 小 均 为 12 个 像素 。 

2) 类 型 选择 符 
类 型 选择 符 就 是 以 文档 语言 对 象 类 型 作为 选择 符 , 即 使 用 结构 中 的 元 素 名 称 作 为 选择 
符 。 所 有 的 页 面 元 素 都 可 以 作为 类 型 选择 符 , 例 如 body、div、p 等 。 


div(font- size: 12px; } 


该 样式 实现 的 效果 是 页 面 中 所 有 div 元 素 包含 的 内 容 的 字体 大 小 为 12 个 像素 。 
3) 包含 选择 符 
包含 选择 符 的 格式 如 下 : 


选择 符 1 选择 符 2 
选择 符 1 与 选择 符 2 之 间 用 空格 分 隔 , 含 义 是 所 有 选择 符 1 中 包含 选择 符 2。 例 如 : 
div p(font- size: 12px} 
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4) ID 选择 符 
ID 选择 符 的 格式 如 下 : 


# name 
ID 选择 符 的 语法 格式 是 “#? 加 上 自 定义 的 ID 名 称 。 例 如 : 
# name(font- size: 12px} 


该 样式 实现 的 效果 是 ,在 所 有 调用 ID 名 称 为 name 的 页 面 元 素 中 文本 的 字体 大 小 为 
12 个 像素 。 用 户 需要 注意 的 是 ,ID 选择 符 的 名 称 在 页 面 中 是 唯一 的 。 如 果 在 页 面 中 定义 
T ID 选择 符 的 名 字 为 name, 则 页 面 中 其 他 ID 选择 符 的 名 称 不 能 以 name 命名 。 

5) 类 选择 符 

类 选择 符 的 格式 如 下 : 


.name 
类 选择 符 的 语法 格式 是 “. ”加 上 自 定义 的 类 名 称 。 例 如 : 
.name{font - size: 12px} 


该 样式 实现 的 效果 是 ,在 所 有 调用 类 名 称 为 name 的 页 面 元 素 中 文本 的 字体 大 小 均 为 
12 个 像素 。 类 选择 符 的 名 称 在 页 面 中 不 是 唯一 的 ,可 以 通过 定义 相同 的 类 名 来 调用 同一 个 
样式 。 

6) 选择 符 分 组 

当 多 个 选择 符 应 用 相同 的 样式 时 ,可 以 将 选择 符 用 英文 逗号 分 隔 的 方式 合并 为 一 组 : 


选择 符 1, 选择 符 2, 选择 符 3 
例如 : 
. name, div, p{font - size: 12px} 


该 样式 实现 的 效果 是 ,在 类 名 字 为 name 的 元 素 div 元 素 .p 元 素 中 文本 的 字体 大 小 为 
12 个 像素 。 

3. 属性 

属性 是 CSS 中 最 重要 的 部 分 ,也 是 最 复杂 的 部 分 ,常用 的 属性 有 字体 属性 、 文 本 属性 、 
背景 属性 .定位 属性 .尺寸 属性 ,布局 属性 .边界 属性 ,边框 属性 、 补 白 属性 、 列 表 项 目 属 性 、 表 
格 属性 。 其 中 , 某 些 属性 只 有 部 分 浏览 器 支持 ,这 使 属性 的 应 用 变 得 更 加 复杂 。 属 性 的 应 用 
是 CSS 应 用 的 主体 部 分 ,请 大 家 在 使 用 过 程 中 特别 关注 。 

4. 伪 类 和 伪 元 素 

伪 类 和 伪 元 素 也 是 一 种 选择 符 ,在 页 面 元 素 中 用 来 定义 超出 结构 所 能 标识 的 样式 。 伪 
类 是 能 被 支持 CSS 的 浏览 器 自动 识别 的 特殊 选择 符 。 伪 类 的 语法 结构 如 下 : 


选择 符 伪 类 { 属 性 : 属性 值 } 
例如 : 


a: hover(font- size: 12px; } 


该 样式 实现 的 效果 是 , 当 鼠 标 悬 停 在 带 有 链接 的 文本 上 时 ,文本 字体 大 小 为 12 个 
像素 。 

伪 类 和 伪 元 素 一 般 是 以 “: 开头。 与 类 不 同 的 是 , 伪 类 和 伪 元 素 在 CSS 中 是 指定 的 ,不 
能 随意 命名 和 定义 。 


4.2.4 CSS 样式 属性 


CSS 样式 属性 是 CSS 应 用 的 重点 ,下 面 简单 介绍 本 系统 中 使 用 的 一 些 基 本 布局 属性 。 

1. 定位 属性 

定位 属性 包括 3 个 方面 , 即 定位 模式 (position) . 边 偏 移 (top right, bottom, lef MEA 
定位 属性 (z-index) 。 

1) 定位 模式 

它 是 一 个 不 可 继承 的 属性 。 其 语法 结构 如 下 : 


position:static | relative | absolute | fixed; 


static; 元 素 按照 普通 方式 生成 , 即 元 素 按 照 HTML 的 规则 进行 定位 ; 
relative: 元 素 将 保持 原来 的 大 小 偏 移 一 定 的 距离 s 

absolute; 元 素 将 从 页 面 元 素 中 被 独立 出 来 ,使 用 边 偏 移 进行 定位 ; 
fixed; 元 素 将 从 页 面 元 素 中 被 独立 出 来 ,但 其 位 置 是 相对 于 屏幕 本 身 ,而 不 是 文档 
的 本 身 。 

2) 边 偏 移 

边 偏 移 包 括 top、right、bottom 和 left 4 个 属性 。 

* top: 定义 元 素 相对 于 其 父 元 素 上 边线 的 距离 ; 

* right: 定义 元 素 相对 于 其 父 元 素 右 边线 的 距离 ; 

* bottom: 定义 元 素 相 对 于 其 父 元 素 下 边线 的 距离 ; 

* left; 定义 元 素 相对 于 其 父 元 素 左 边线 的 距离 。 

其 语法 结构 如 下 (以 top 属性 为 例 ): 


top: auto | 长 度 值 | 百分比 值 
30 层 登 定位 属性 
层 释 定位 属性 ( 即 z-index 属性 ) 用 来 定义 元 素 的 层 秋 顺序。 其 语法 结构 如 下 : 


z- index: 数 字 值 


数字 值 为 没有 单位 的 数字 值 ,并 且 可 以 取 负 数值 。 

2. 背景 属性 

页 面 背景 的 设置 一 般 包括 背景 颜色 .背景 图 片 . 背 景 颜色 和 背景 图 片 混合 等 多 种 方式 ， 
这 些 方式 也 同样 适用 于 页 面 中 元 素 的 背景 。 

1) 背景 色 

其 语法 结构 如 下 : 


background - color :颜色 值 ; 
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2) 背景 图 片 
其 语法 结构 如 下 : 


background - image:url( 图 片 路 径 ); 


3) 背景 图 片 的 重复 
背景 图 片 的 重复 属性 ( 即 background-repeat 属性 ) 是 不 可 以 继承 的 属性 。 其 语法 结构 如 下 ， 


background - repeat:repeat | no- repeat | repeat-x | repeat - y; 


* repeat; 背景 图 片 按 照 从 左 到 右 、 从 上 到 下 的 顺序 进行 排列 ; 

* no-repeat; 背景 图 片 不 重复 ,在 没有 定义 位 置 时 ,默认 出 现在 容器 的 左上 角 ; 

* repeat-x: 背景 图 片 横向 排列 ,在 没有 定义 位 置 时 ,在 容器 顶部 从 左 向 右 重 复 排列 ; 

* repeat-y; 背景 图 片 纵 向 进行 排列 ,在 没有 定义 位 置 时 ,在 容器 左 侧 从 上 向 下 重复 
排列 。 

4) 背景 图 片 位 置 

背景 图 片 的 位 置 属性 是 不 可 继承 的 。 其 语法 结构 如 下 : 


background - position: 长 度 值 | 百分比 值 |top |right | bottom | left | center; 


长 度 值 和 百分比 值 : 背景 图 片 按照 设置 的 具体 数值 确定 位 置 ; 
top: 背景 图 片 出 现在 容器 的 上 边 ; 

* bottom; 背景 图 片 出 现在 容器 的 底 边 ; 

* left; 背景 图 片 出 现在 容器 的 左边 ; 

。 right; 背景 图 片 出 现在 容器 的 右边 ; 

* center; 背景 图 片 横 向 和 纵向 居中 。 

3. 容器 属性 

在 CSS 中 ,所 有 的 文档 元 素 ( 包 括 块 元 素 和 内 联 元 素 ) 都 会 生成 一 个 矩形 框 。 这 个 矩形 
框 由 边界 边框、 补 白 、 宽 度 和 高 度 几 个 部 分 组 成 。 

1) 补 白 属性 

在 CSS 中 , 补 白 属性 是 一 个 不 能 继承 的 属性 。 其 语法 结构 如 下 : 


padding: 长 度 值 | 百分比 值 ; 


2) 边框 属性 
边框 属性 包括 边框 样式 属性 ,边框 宽度 属性 ,边框 颜色 . 单 侧 的 边框 等 。 
CD 边框 样式 : 边框 样式 属性 是 一 个 不 可 继承 的 属性 。 其 语法 结构 如 下 : 


border - style:none | hidden | dotted | dashed | solid | 
double | groove | ridge | inset | outset; 


(2) 边框 宽度 : 边框 宽度 属性 是 一 个 不 可 继承 的 属性 。 其 语法 结构 如 下 : 
border - width:medium | thin | thick | 长 度 值 ; 
(3) 边框 颜色 :边框 颜色 属性 是 一 个 不 可 继承 的 属性 。 其 语法 结构 如 下 : 


border - color :颜色 值 ; 


3) 边界 属性 
边界 属性 是 一 个 不 可 继承 的 属性 。 其 语法 结构 如 下 : 


margin:auto | 长 度 值 | 百分比 值 ; 


4.3 主要 页 面 设计 


根据 第 3 章 中 系统 的 总 体 规 划 , 用 户 使 用 该 办 公 自 动 化 管理 系统 要 经 过 系统 首页 一 用 
户 登录 一 系统 主页 3 个 页 面 转向 过 程 。 常 用 的 办 公 自 动 化 系统 一 般 不 设 系统 首页 ,而 是 将 
系统 首页 与 登录 界面 合 二 为 一 。 设 置 系统 首页 也 有 其 优点 ,可 以 在 这 里 对 系统 功能 、 使 用 方 
法 以 及 注册 登录 等 相关 注意 事项 进行 说 明 。 下 面 完 成 “系统 首页 “用 户 登 录 ” 以 及 “系统 主 
页 ”页 面 的 设计 与 显示 。 


4.3.1 系统 首页 设计 


1. 添加 文件 夹 

在 第 2 章 中 ,我 们 通过 Zend Studio 集成 开发 环境 创建 了 名 为 wmProject 的 Zend 
Framework 项 目 。 现 在 ,在 该 项 目的 public 目录 中 添加 文件 夹 css js images, 分 别 用 来 存 
ji CSS PÉIR NAF „JavaScript 脚本 文件 以 及 图 片 文件 。 

在 Zend Studio 集成 开发 环境 左 侧 的 工作 区 中 单 击 public 文件 夹 ,右键 打开 快捷 菜单 ， 
选择 New| Folder 菜单 项 ,进入 新 建文 件 夹 对 话 框 ,输入 文件 夹 名 称 , 单 击 Finish 按钮 ,完成 
文件 夹 的 创建 。 

为 了 操作 方便 ,我 们 在 新 创建 的 css 文件 夹 下 青 创建 一 个 名 为 img 的 文件 夹 , 专 门 存放 
作为 背景 的 图 片 资 源 。 

2. 添加 文件 

在 创建 的 css 文件 夹 中 添加 layout. css 和 style. css 样式 文件 。 

在 Zend Studio 集成 开发 环境 左 侧 的 工作 区 中 选择 public 目录 下 的 ess 文件 夹 ,右键 打 
开 快捷 菜单 ,选择 New|CSS File 菜单 项 ,打开 新 建文 件 对 话 框 , 输 入 文件 名 称 , 单 击 Finish 
按钮 ,完成 样式 文件 的 添加 。 然 后 双击 打开 样式 文件 ,添加 页 面 样式 代码 。 

3. 添加 图 片 资 源 

将 准备 好 的 图 片 资源 放 入 images 或 css 目录 下 的 img 文件 夹 中 。 在 第 2 章 中 介绍 过 ， 
Zend Studio 集成 环境 支持 工作 区 的 直接 复制 与 粘贴 ,将 图 片 复 制 到 剪贴 板 上 ,然后 直接 粘 
贴 到 这 两 个 文件 夹 中 即 可 。 

4. 添加 页 面 视图 代码 

系统 主页 采用 第 2 章 中 图 2. 10 所 示 的 系统 欢迎 页 面 , 该 页 面 的 控制 器 与 方法 是 由 ZF 
Tool 工具 命令 自动 生成 的 。 

打开 系统 主页 视图 文件 application\views\scripts\index\index. phtml, 删 除 文 件 原 有 
的 全 部 内 容 , 添 加 如 下 代码 : 


<?php echo $ this—>docType(); ?> 
<html> 


A d ELA layout 4k E HR 


Hay 


PHP Zend Framework 9i H FX sh HHE 


< head» 
«meta http- equiv = "Content - Type" content = "text/html; charset = gb2312" /> 
« link href = "/css/layout.css" rel = "stylesheet" type- "text/css" /> 
< link href = "/css/style.css" rel- "stylesheet" type = "text/css" /> 
?php echo $ this —» headTitle();?» 
< style type = "text/css"» 

a(outline:none] 

img(border - style:none;] 
</style> 
</head> 
< body id = "mainBg"» 
<div id= "wrap"> 

< div id = "mainImg01"></div > 

<div id= "mainImg02"> 

<a href = "/user/login" > 
< img alt = " 单 击 进入 " src = "/images/enter. png" /> 
</a> 
</div> 
<div id = "mainImg03"></div > 

</div> 
</body> 
</html> 


上 述 代 码 非常 简单 ,由 最 基本 的 网 页 元 素 组 成 ,需要 注意 的 是 代码 中 的 3 处 阴影 部 分 。 
阴影 代码 的 第 1.2 两 个 部 分 设置 该 页 面 的 文档 类 型 与 标题 ,在 本 章 的 4. 1. 1 节 中 设置 了 视 
图 对 象 的 “文档 类 型 ”与 “文档 标题 ”两 个 属性 ,这 里 通过 Zend Framework 的 视图 助手 ( 占 位 
符 助 手 ) 在 视图 页 面 中 输出 这 些 设置 。 阴 影 代码 的 第 3 部 分 是 从 主页 进入 用 户 登录 页 面 的 
超级 链接 ,链接 中 的 href 属性 值 为 /user/login, 表 示 单 击 该 链接 ,页 面 会 跳 转 到 User 控制 
器 的 login 方法 视图 页 面 。 

打开 XAMPP 控制 面板 ,启动 Apache 服务 器 ,在 浏览 器 的 地 址 栏 中 输入 http:// 
wmoams. com ,系统 首页 效果 如 图 4. 1 所 示 。 


XH WE SEV GRA) IAD who 
keak |j Masaur panas p nsum 
网 hapywmoamscony -D-O mo- 2207 IMQ- 9. " 


图 4.1 系统 首页 效果 图 
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1. 创建 控制 器 

在 第 2 章 中 学 习 了 Zend Framework 项 目的 结构 与 运行 机 制 ,了 解 了 它 的 MVC 设计 模 
式 与 路 由 规则 。Zend Framework 应 用 的 所 有 视图 页 面 都 必须 由 相应 的 控制 器 进行 管理 ， 
要 在 特定 的 页 面 中 显示 数据 ,必须 创建 相应 的 控制 器 与 方法 。 

打开 Zend Studio 集成 开发 环境 , 单 击 wmProject 项 目 中 的 任何 一 个 文件 夹 或 文件 。 
然后 选择 Project| Zend Tool 菜单 项 ,打开 ZF Tool 命令 工具 窗口 ,输入 命令 ; 


zf create controller User 


在 默认 模块 default 中 创建 一 个 名 为 User 的 控制 器 。 其 中 ,User 为 自 定义 的 控制 器 名 
字 ; 控制 器 名 字 的 首 字 母 可 以 大 写 也 可 以 小 写 , 若 为 小 写 ,ZF Tool 工具 会 自动 将 其 改 为 大 
写 后 生成 名 为 UserController 的 控制 器 类 。 控 制 器 名 字 最 好 用 单个 单词 ,若非 要 用 多 个 单 
词 ,最 好 用 下 划 线 ″ ?连接 ,以 免 Zend Framework 框架 在 搜索 资源 时 出 现 错误 。 
根据 ZF Tool 命令 行 语法 格式 , User 控制 器 名 的 后 面 应 该 是 控制 器 所 属 的 模块 名 ,这 
里 省 略 了 该 参数 , 即 为 默认 模块 ,默认 模块 名 为 default. 
上 述 命令 生成 的 User 控制 器 文件 UserController. php 位 于 application\ controllers 目录 
下 ,其 代码 如 下 : 
class UserController extends Zend Controller Action 
{ 
public function init() 
{ 
/ * Initialize action controller here * / 
) 
public function indexAction() 
{ 
//action body 
} 
} 
从 上 述 代码 可 以 看 出 ,所 谓 的 “控制 器 ”实际 上 是 一 个 继承 于 Zend. Controller. Action 
的 类 ,并 且 默 认 生成 了 init 初始 化 方法 与 index 方法 。init 方法 用 于 User 控制 器 中 所 有 方 
法 (action) 的 初始 化 , 它 不 对 应 视图 (View) ,而 index 方法 对 应 相应 的 视图 。 
从 项 目 目 录 中 可 以 看 到 ,在 application/views/scripts 目录 中 ,ZF Tool 工具 自动 生成 
了 一 个 名 为 User 的 文件 夹 ,这 个 文件 夹 中 存放 的 就 是 User 控制 器 中 的 所 有 方法 对 应 的 视 
图 文件 。 现 在 User 控制 器 中 还 只 有 名 为 index 的 方法 ,所 以 文件 夹 中 只 有 一 个 名 为 index. 
phtml 的 页 面 文件 。 注 意 ,视图 文件 夹 名 与 控制 器 名 相同 ,视图 文件 名 与 方法 名 相同 ,视图 
文件 的 扩展 名 为 phtml。 
2. 添加 方法 
为 了 能 通过 方法 的 名 称 推测 其 功能 .下 面 创建 一 个 名 为 login 的 方法 来 处 理 用 户 登 录 
请 求 。 
在 Zend Studio 集成 开发 环境 中 使 用 与 上 面相 同 的 方法 打开 ZF Tool 命令 窗口 ,输入 命令 : 
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Zf create action login User 


在 User 控制 器 中 创建 一 个 名 为 login 的 方法 。 上 述 命令 中 的 login 为 方法 名 ,User 为 
控制 器 名 。 打 开 application\controllers\UserController. php 文件 ,可 以 看 到 ZF Tool 工具 
创建 的 loginAction 方法 。 它 是 UserController 控制 器 类 的 一 个 成 员 函 数 。 

上 述 命令 还 在 application\views\scripts\user 目录 下 创建 了 与 login 方法 同名 的 视图 
文件 login. phtml。 

3. 设计 登录 视图 

系统 用 户 登 录 页 面 结 构 如 图 4. 2 所 示 。 
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图 4.2 用 户 登 录 页 面 效 果 图 


从 图 4.2 可 以 看 出 ,在 垂直 方向 上 用 户 登录 页 面 可 以 分 为 3 个 区 域 : 顶部 为 企业 logo 
及 系统 标题 ,底部 为 页 面 脚 标 ; 中 部 为 用 户 登录 区 ,登录 区 的 右边 是 登录 表单 设置 区 。 

由 于 本 系统 是 基于 Zend Framework 框架 的 ,我们 将 采用 Zend. Form 表单 实现 登录 操 
作 。Zend_Form 表单 具有 多 项 验证 功能 .能 够 增强 系统 的 安全 性 ,详细 内 容 将 在 第 6 章 中 
介绍 。 

打开 application\views\scripts\user\login. phtml 视图 文件 ,删除 原 有 全 部 内 容 , 添 加 
如 下 代码 : 


<?php echo $ this -> docType(); ?> 

<html> 

< head> 

< meta http- equiv = "Content - Type" content = "text/html; charset = gb2312" /> 
< link href = "/css/layout. css" rel = "stylesheet" type = "text/css" /> 

< link href = "/css/style.css" rel = "stylesheet" type = "text/css" /> 

<?php echo $ this -> headTitle( ) ;?> 

</head> 

< body id = "mainBg"> 


<div id= "header" style = "border - bottom:1px solid 井 cccccc "> 
<div id= "logo"»« img src = "/ images/1logo. jpg"></div > 
</div> 
<div id= "wrap"> 
< div id= "login center" 
<div class = "left"» 
< img src = "/images/login center nark.gif" /»«/div» 
< div class = "center"></div> 
<div class = "right"»«/div» 
«/div» 
</div> 
<div id= "header" style = "border - top:lpx solid 井 cccccc"> 
< span id= "footerText"> 微 梦 软件 — 微 梦 办 公 自 动 化 管理 系统 
http://www. wnstudio. net. cn</span></div> 
</body> 
</html> 


4.3.3 系统 主页 设计 


1. 系统 主页 结构 
用 户 登录 成 功 后 进入 系统 主页 ,如 图 4. 3 所 示 。 
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图 4.3 系统 主页 效果 图 


根据 用 户 对 各 个 功能 模块 的 使 用 频率 和 重要 程度 ,本 系统 的 首页 页 面 中 的 显示 模块 主 
要 分 为 以 下 5 个 部 分 。 

* 系统 首页 导航 区 : 包括 系统 导航 菜单 、 当 前 用 户 、 时 间 等 ; 

。 系统 左 侧 导 航 区 : 包括 用 户 常用 菜单 ; 

* 系统 主 显 示 区 : 默认 显示 通知 公告 .最 新 公文 .个 人 日 程 以 及 最 新 消息 ; 

。 系统 右 侧 提示 区 : 默认 显示 待 办 事务 与 近期 工作 安排 ; 
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。 系统 底部 显示 区 : 显示 版 权 等 信息 。 

2. 添加 方法 

在 上 面 的 演示 中 ,系统 首页 页 面 对 应 的 是 Index 控制 器 的 index 方法 ,所 以 需要 在 
Index 控制 器 中 为 系统 主页 另外 添加 一 个 main 方法 。 

在 Zend Studio 集成 开发 环境 中 使 用 与 上 面相 同 的 方法 打开 ZF Tool 命令 窗口 ,输入 
命令 : 

Zf create action main Index 


在 Index 控制 器 中 创建 名 为 main 的 方法 。 

3. 主页 页 面 设计 

对 于 系统 的 内 部 页 面 , 不 同 的 数据 类 型 应 具有 不 同 的 布局 方式 ,但 有 些 公共 的 或 特别 重 
要 的 内 容 需 要 时 时 刻 刻 显示 在 页 面 上 。 例 如 ,在 如 图 4. 3 所 示 的 系统 主页 中 , 左 、 右 两 侧 框 
架 中 所 显示 的 内 容 就 需要 在 系统 的 每 个 页 面 上 都 能 显示 出 来 。 如 果 不 采取 某 些 技 术 措 施 ， 
需要 在 系统 的 每 个 页 面 上 添加 这 些 相 同 的 代码 ,这 显然 是 不 合适 的 。 为 此 ,我 们 启用 Zend 
Framework 框架 的 布局 模板 ,所 有 信息 都 在 这 个 模板 页 面 上 显示 出 来 ,这 样 既 有 利于 代码 
的 更 新 ,也 保持 了 整个 系统 页 面 的 统一 性 。 
先 看 一 下 系统 内 部 页 面 的 布局 模板 效果 ,如 图 4.4 所 示 。 
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图 4.4 布局 模板 页 面 效 果 图 


D 开启 模板 功能 
在 Zend Studio 集成 开发 环境 的 工作 区 中 选择 wmProject 项 目 ,定位 到 项 目 内 部 的 文 
件 或 文件 夹 上 ,选择 Project| Zend Tool 菜单 项 ,打开 Zend Tool 工具 命令 窗口 .输入 命令 : 


Zf enable layout 


开启 Zend Framework 的 布局 模块 功能 。 若 命令 执行 成 功 , 打 开 application 文件 夹 ,就 能 够 


看 到 上 述 Zend Tool 命令 创建 的 layout 文件 夹 和 layout. phtml 页 面 文件 。 另 外 ,在 application\ 
configsVapplication. ini 中 ,也 可 以 看 到 多 了 一 条 如 下 的 配置 代码 , 它 定 义 了 layout 模板 布 
局 文件 所 在 的 路 径 , 即 layout. phtml 文件 路 径 。 


resources. layout. layoutPath = APPLICATION PATH "/layouts/scripts/" 


布局 模板 开启 后 ,系统 中 所 有 的 视图 内 容 都 将 通过 layout. phtml 页 面 显 示 出 来 ,当然 
也 包括 系统 界面 首页 以 及 用 户 登录 页 面 。 很 显然 ,这 两 个 页 面 用 图 4.4 所 示 的 结构 显示 是 
不 合适 的 。 通 过 下 面 的 方法 ,可 以 在 不 必要 的 时 候 关 闭 layout 布局 模板 。 


$ this—>_helper -> layout - » disableLayout(); 


将 该 代码 分 别 添加 于 Index 控制 器 的 Index 方法 、User 控制 器 的 login 方法 中 ,关闭 这 
两 个 控制 器 方法 所 对 应 的 视图 页 面 、 在 显示 时 布局 模板 的 使 用 , 即 直接 显示 这 两 个 页 面 的 视 
图 文件 内 容 ,就 像 我 们 前 面 做 的 一 样 。 


class IndexController extends Zend Controller Action 
{ 


public function indexAction() 
{ 
$ this->_helper -> layout ~ > disableLayout(); 
) 
} 
class UserController extends Zend_Controller_Action 


{ 


public function loginAction() 
i $ this-» helper -> layout - > disableLayout(); 
} 

j 

代码 中 使 用 的 _helper 是 Zend Framework 的 “动作 助手 ”, 详 细 内 容 将 在 第 11 章 进 行 
介绍 。 

2) 设计 模板 页 面 

分 析 如 图 4. 4 所 示 的 模板 页 面 结构 ,可 以 将 其 分 成 5 个 区 ,如 图 4.5 所 示 。 

3) 编写 布局 页 面 代码 

在 图 4. 5 所 示 的 页 面 结构 中 , 除 主 显示 区 以 外 ,其 余 4 个 显示 区 都 是 固定 的 。 也 就 是 
说 ,这 4 个 区 中 的 内 容 是 必须 显示 在 每 个 页 面 上 的 。 由 此 ,我 们 把 这 4 个 显示 区 分 别 用 
header. phtml, left. phtml right. phtml 和 footer. phtml 4 个 视图 文件 表示 。 

在 Zend Studio 项 目 工作 区 中 选择 application\ layouts\ scripts 文件 夹 ,右键 打开 快捷 
菜单 ,选择 New| PHP File 菜单 项 ,打开 创建 新 PHP 文件 对 话 框 ,输入 文件 名 后 单 击 Finish 
按钮 完成 。 为 了 保持 视图 文件 类 型 统一 ,注意 将 文件 扩展 名 改 为 phtml。 

打开 application\layouts\scripts 文件 夹 中 的 5 个 视图 文件 ,分别 添加 代码 。 
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左 侧 国定 内 容 区 上 | 主 显示 区 -显示 不 同 的 内 容 ( 右 催 国定 内 容 区 


4.5 布局 模板 结构 
CD 视图 文件 layout. html 代码 : 


<?php echo $ this -> docType( );?> 

<html> 

< head> 

< meta http- equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
< link href = "/css/layout.css" rel = "stylesheet" type= "text/css" /> 

< link href = "/css/style.css" rel = "stylesheet" type = "text/css" /> 

<?php echo $ this -> headTitle();?> 


</head> 
< body> 
<div id= "wrap"> 
<?php 
echo $ this -> partial( header. phtml'); 
?> 
<div id= "main"> 
<div id = "sidebar"><?php echo $ this -> partial('left.phtml');?></div> 
<div id= "leftframe"»«/div» 
« div id= "content"></div> 
<div id= "right"><?php echo $ this -> partial('right. phtml');?></div > 
<div id= "rightframe"></div> 
</div> 
<?php echo $ this -> partial('footer.phtml'); ?> 
</div> 
</body> 
</html> 


(2) 视图 文件 header. phtml 代码 : 


<div id= "header"> 
<div id= "logo">< img src = "/images/1ogo. jpg"></div > 
</div> 


(3) 视图 文件 footer. phtml 代码 : 


«div id= "footer"> 
2014 All rights reserved. www. wmstudio. net. cn copyright 微 梦 工 作 室 
</div> 


(4) 视图 文件 left. phtml 和 right. phtml 代码 见 源 代 码 。 


4.4 layout 布局 模板 


上 面 介绍 了 layout 布局 模板 的 开启 .关闭 方法 及 其 视图 文件 结构 ,下 面 较为 详细 地 说 
明 它 的 特点 及 一 些 常 用 方法 的 使 用 。 


4.4.1 布局 模板 概述 


Zend Framework 的 Zend. Layout 组 件 实现 layout 布局 模板 功能 。Zend_Layout 类 实 
现 了 经 典 的 两 步 视 图 (two step view) 模 型 ,允许 把 应 用 程序 的 内 容 包装 在 另 一 个 视图 中 ,所 
以 一 般 作 为 系统 的 模板 使 用 。 

如 果 要 更 多 地 了 解 Zend Framework 的 布局 模板 ,读者 可 以 查看 Zend Framework 使 用 
手册 或 直接 查看 Zend Framework 库 文 件 中 的 zendMayou. php 源 文 件 。 

在 Zend Studio 集成 开发 环境 中 打开 库 文件 layout. php ,查看 类 Zend. Layout 的 定义 ， 
其 成 员 变量 及 成 员 函 数 如 图 4. 6 所 示 。 


© .setMvcEnabled($mvcEnabled) ^ 
assign($spec, $valueznull) 
disablelnflector0 
disableLayout() 
enablelnflector0 
enableLayout0 


getContentKey0 
getHelperClass0 
getinfiectorü 
getinfiectorTarget) 
getLayout0 


getLayoutPath0 
S_mvcSuccessfulActionOnly © getMvcEnabled0 
$. pluginClass $ getMvcinstance0 
$ view getMvcSuccessfulActionOnlyQ 
$ viewBasePath getPluginClassQ 
© $ viewBasePrefix 
o $ viewScriptPath 
S, viewSuffix 
construct($options=null, $ 
—get(Skey) 
—isset(Skey) 
—set(Skey, $value) 
—unset(Skey) 
© jnitHelper0 


图 4.6 类 Zend_Layout 成 员 变 量 及 方法 


在 Zend Framework 中 开启 layout 布局 ,实际 上 就 是 调用 了 Zend Layout 类 的 startMvc() 
Jiik.Zend Layout 自动 在 front controller 中 注册 一 个 Zend Layout Controller Plugin | 
Layout 的 插件 资源 ,就 像 前 面 在 配置 文件 中 所 看 到 的 resources. layout 那样 。 这 个 插件 类 
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中 的 postDispatch 方法 负责 把 视图 文件 (script) 的 内 容 放 到 模板 (layout) 的 预 留 位 置 中 ,一 
般 默认 名 为 content, 此 即 为 两 步 视 图 在 Zend Framework 中 实现 的 关键 。 


4.4.2 布局 模板 的 关闭 


图 4.6 中 列 出 了 zend_Layout 类 的 一 些 常 用 方法 ,通过 这 些 方法 可 以 对 layout 模板 布 
局 进行 操作 。 在 前 面 的 操作 中 使 用 代码 : 


$ this-» helper -> layout - » disableLayout(); 


来 关闭 布局 模板 ,其 中 的 方法 disableLayout 实现 布局 模板 的 关闭 。 
从 这 里 也 可 以 看 出 ,代码 中 的 layout 应 该 是 Zend. Layout 类 的 实例 (对 象 )。 其 中 的 
_helper 是 Zend Framework 框架 的 动作 助手 ,通过 它 可 以 很 方便 地 完成 一 些 操作 。 


4.4.3 多 个 布局 模板 的 使 用 


从 图 4.6 列 出 的 类 Zend_Layonut 方法 中 可 以 找到 一 个 名 为 setLayonut 的 方法 ,这 个 方 
法 是 用 来 设置 新 布局 模板 的 。 其 源 代码 如 下 : 


public function setLayout( $ name, $ enabled = true) 
{ 
$this-» layout- (string) $ name; 
if ( $ enabled) ( 
$ this - > enableLayout(); 
) 
return $ this; 


) 


调用 该 方法 需要 带 一 个 或 两 个 参数 ,name 为 新 布局 的 名 字 , 即 新 布局 文件 * . phtml 的 文 
件 名 。 该 方法 中 调用 了 enableLayout 方法 启用 布局 模板 。 

【 例 4.1】 在 项 目 wmProject 中 使 用 新 模板 admin。 

(1) 设计 新 布局 模板 文件 。 

在 Zend Studio 集成 开发 环境 中 选择 工作 区 中 的 wmProject 项 目下 的 application\ 
layouts\scripts 文件 夹 , 右 击 该 文件 夹 新 建文 件 admin. phtml, 并 添加 代码 : 


<?php echo $ this -> docTYpe( ) ;?> 
<html> 
< head> 
< meta http- equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
< link href = "/css/layout. css" rel = "stylesheet" type = "text/css" /> 
< link href = "/css/style.css" rel = "stylesheet" type = "text/css" /> 
<?php echo $ this -> headTitle();?» 
</head> 
< body> 
<div id= "wrap"> 
<?php echo $ this -> partial( 'header. phtml'); ?> 
<div id= "main"> 
<div id= "sidebar"></div> 
<div id= "content" style = "width:78 $ "> 


<?php echo $ this -> layout() -> content; ?> 
</div> 
</div> 
<?php echo $ this - > partial('footer.phtml'); ?> 
</div> 
</body> 
</html> 


在 上 述 阴 影 部 分 代码 中 ,layout 是 Zend Framework 的 视图 助手 ,content 是 启用 了 该 
布局 模块 的 控制 器 所 对 应 的 视图 文件 内 容 。 如 果 在 User 控制 器 的 index 方法 中 启用 admin 
布局 模板 , 则 content 即 代 表 application\views\scripts\user\index. phtml 视图 页 面 内 容 。 

(2) 在 控制 器 的 方法 中 添加 代码 ,启用 新 布局 模板 。 

打开 User 控制 器 的 index 方法 ,添加 如 下 代码 : 


class UserController extends Zend Controller Action 


{ 


public function indexAction() 
( 


$ this-» helper -> layout - > setLayout( 'admin'); 
} 
} 
(3) 在 浏览 器 的 地 址 栏 中 输入 http://wmoams. com/ User, 页 面 效果 如 图 4.7 所 示 。 
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图 4.7 新 布局 模板 的 页 面 效果 


从 图 4.7 中 可 以 看 出 ,新 布局 模板 采用 经 典 的 左右 页 面 形式 , 右 主 显示 区 中 的 文本 来 自 
application\views\scripts\user\index. phtml 页 面 。 这 说 明 , 要 显示 的 视图 内 容 被 布局 管理 
器 控制 在 了 布局 中 的 一 块 区 域 ,这 个 区 域 的 内 容 可 以 动态 显示 。 
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4.4.4 布局 文件 目录 的 更 改 


在 开启 Zend Framework 的 layout 布局 模板 后 会 生成 默认 的 布局 文件 目录 , 即 applicationN 
layouts\scripts 目录 。 这 个 目录 在 application\configs\application. ini 文件 中 被 定义 ,可 以 
通过 Zend Layout 类 的 setLayoutPath 重新 设置 布局 文件 路 径 ,这 样 可 以 对 布局 文件 进行 
分 类 管理 。 

【 例 4. 2】 将 上 述 新 布局 文件 admin. phtml 存放 在 目录 mylayouts 中 。 

(1) 在 项 目 wmProject 的 application 下 新 建文 件 夹 mylayoutsNscripts。 

(2) 将 布局 文件 admin. phtml 复制 到 新 文件 夹 中 ,删除 原 layouts\scripts 文件 夹 中 的 
布局 文件 。 

(3) 将 admin. phtml 文件 中 需要 包含 的 文件 (例如 header. phtml 和 footer. phtml) 一 并 
复制 到 新 文件 夹 下 。 

(4) 在 控制 器 的 方法 中 添加 代码 ,设置 新 布局 文件 的 路 径 , 假 如 还 是 用 User 控制 器 的 
index 方法 进行 测试 , 则 代码 如 下 : 


class UserController extends Zend Controller Action 
{ 


public function indexAction() 


$this-» helper -> layout - > setLayout( 'admin'); 
$ this-» helper -> layout -> setLayoutPath( 
APPLICATION PATH. '/mylayout/scripts'); 


) 


(5) 在 浏览 器 地 址 栏 中 输入 http: //wmoams. com/user. 9t ifi X 8 5j [8] 4. 7 相同 ,说 明 
Zend Fromwork 在 新 的 路 径 下 找到 了 新 的 布局 文件 。 


4.4.5 布局 文件 名 称 的 修改 


在 项 目 中 开启 布局 模板 后 ,Zend Framework 生成 了 一 个 默认 的 名 为 layout. phtml 的 
布局 文件 。 虽 然 可 以 用 上 面 介绍 的 方法 关闭 .启用 新 布局 ,但 当 项 目 中 的 控制 器 比较 多 的 时 
候 , 这 种 方法 显得 比较 麻烦 ,并 且 修 改 起 来 也 不 方便 。 这 时 ,可 以 使 用 Zend Framework 提 
供 的 插件 功能 通过 编写 插件 来 改变 Zend Framework 框架 的 路 由 规则 ,从 而 更 改 默认 布局 
页 面 文件 的 名 称 ,关于 这 方面 的 知识 ,在 后 面 的 章节 中 再 进行 介绍 。 


4.5 本 章 小 结 


本 章 通 过 实现 系统 首页 、 用 户 登 录 以 及 系统 主页 页 面 进一步 学 习 了 Zend Framework 
项 目的 运行 机 制 ,使 读者 更 直接 地 理解 了 MVC 模式 中 控制 器 与 视图 之 间 的 相互 关系 ,同时 
以 此 为 基础 详细 介绍 了 Zend Framework 的 Zend Layout 组 件 功能 及 使 用 方法 。 

Zend. Layout 组 件 是 本 章 的 重点 ,该 组 件 实现 了 Zend Framework 应 用 的 layout 两 步 视图 
模式 ,使 得 项 目 布局 更 加 合理 、 模 板 代 码 更 加 简洁 ,大 大 提高 了 代码 的 可 重用 性 ,减少 了 元 余 。 


第 5 章 页 面 导 航 及 Zend Db 数据 库 


页 面 导 航 和 数据 库 操作 是 每 个 Web 应 用 都 不 可 缺少 的 ,Zend Framework 框架 提供 了 
专门 的 组 件 来 实现 这 两 项 功能 。Zend Framework 的 Zend. Navigation 组 件 用 于 创建 导航 
菜单 .面包 屑 导航 或 网 站 地 图 ,Zend_Db 组 件 使 用 类 的 封装 机 制 实 现 了 对 数据 库 的 各 种 
操作 。 

本 章 通 过 案例 项 目的 菜单 制作 以 及 新 闻 文 章 显示 的 实现 ,介绍 Zend Framework 中 的 
页 面 导 航 及 数据 库 操作 。 


5.1 导航 菜单 


Zend Framework 框架 使 用 Zend_Navigation 组 件 创建 导航 菜单 ,在 使 用 这 个 组 件 时 ， 
需要 XML 或 INI 文件 的 配合 。 与 传统 的 HTML, CSS 或 JavaScrip 菜单 相 比 , Zend _ 
Navigation 的 导航 实现 并 不 是 很 直观 ,但 它 拥有 代码 量 少 ,动态 功能 强 等 诸多 特性 ,所 以 使 
用 Zend_Navigation 创建 导航 菜单 仍然 是 一 个 很 经 济 的 技术 方案 。 

使 用 Zend Navigation 创建 导航 菜单 一 般 分 为 3 个 步骤 ,首先 创建 一 个 XML 文件, 设 
置 应 用 程序 的 菜单 结构 ; 然后 在 应 用 程序 的 启动 文件 Bootstrap. php 中 初始 化 Zend |. 
Navigation 组 件 ,使 其 能 够 读 取 到 相应 的 资源 ; 最 后 在 视图 页 面 的 适当 位 置 显示 导航 菜单 。 


5.1.1 创建 XML 文件 


可 扩展 标记 语言 XML 是 一 种 灵活 地 传递 数据 的 标记 请 言 ,主要 用 来 定义 结构 .存储 信 
息 、 传 送信 息 ,而 不 是 像 HTML 或 CSS 那样 用 来 表现 或 展示 数据 。 

启动 Zend Studio 集成 开发 环境 ,打开 项 目 wmProject, 选 择 applicationVconfigs 目录 ， 
右 击 该 文件 夹 ,在 弹出 的 快捷 菜单 中 选择 New|XML File 菜单 项 ,在 对 话 框 中 输入 文件 名 
navigation. xml 及 相关 选项 内 容 , 然 后 单 击 Finish 按钮 完成 新 文件 的 创建 。 

双击 打开 navigation. xml 文件 ,添加 如 下 代码 : 


<?xml version = "1.0" encoding = "UTF - 8"?> 
< configdata> 
< company > 
< label > 公司 主页 </label> 
« uri» http://www. wmstudio. net.cn</uri> 
</company > 
< home > 
< label > 首页 </label > 
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< controller index «/controller > 
< action» main «/action» 
x/ hone » 
< docunent > 
< label > 公文 管理 </label > 
< controller > document «/controller > 
« action» index</action> 
< pages» 
«issue» 
< label > 发 文 管理 </label> 
< controller document </controller > 
<action> issue </action> 
</issue> 
< receive> 
< label > 收文 管理 </label> 
< controller document </controller > 
<action> receive «/action» 
«/receive» 
< interfile^ 
< label > 公司 报告 </label > 
< controller > document </controller> 
<action> file</action> 
</interfile> 
< readdoc > 
< label > 文件 传阅 </label > 
< controller > document </controller> 
< action» readdoc </action > 
</readdoc > 
</pages > 
</document > 
«meeting» 
< label > 会 议 管理 </label > 
< controller > meeting </controller> 
< action» index</action> 
< pages> 
< issue> 
< label > 会 议 日 程 </label > 
< controller > meeting </controller > 
<action> plan </action> 
</issue> 
<notice> 
< label > 会 议 通 知 </label > 
< controller» meeting </controller > 
<action> notice </action> 
</notice> 
</pages> 
</meeting> 
<office> 
< label > 事务 管理 </label > 
< controller > office</controller > 
<action> index</action> 


< pages » 
< leadership? 
< label > 领导 日 程 </label > 
< controller > office </controller > 
<action> leadership </action> 
</leadership> 
< request > 
< label > 公用 申请 </label > 
< controller > office </controller> 
< action» request </action> 
</request > 
<vehicle> 
< label > 车 辆 管理 </label > 
< controller > office </controller > 
<action> vehicle «/action» 
«/vehicle» 
< stamper > 
< label > 印章 管理 </label> 
< controller office </controller> 
< action» stamper </action> 
</ stamper > 
< holiday» 
< label > 请 假 管 理 </label > 
< controller > office </controller> 
< action» holiday </action> 
</holiday> 
«repair» 
< label > 报修 管理 </label > 
< controller» office </controller > 
< action» repair </action> 
</repair> 
</pages > 
</office> 
< personal > 
< label > 个 人 办 公 </1label > 
< controller > personal </controller > 
<action> index </action> 
<pages> 
<mymessage> 
< label > 个 人 消息 </label> 
< controller > personal </controller > 
< action > mymessage </action > 
</mymessage> 
< todoitem ^ 
< label > 待 办 事宜 </label > 
< controller > personal </controller > 
<action> todoitem</action> 
</todoitem > 
< doneitem > 
< label > 已 办 事宜 </label > 
< controller» personal </controller > 
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< action» doneitem «/action- 
«/doneitem- 
< worklog^ 
< label > 工作 日 志 </label > 
< controller > personal </controller > 
<action> worklog </action> 
</worklog> 
<myschedule> 
< label > 个 人 日 程 </label> 
< controller > personal </controller > 
< action» myschedule </action > 
</myschedule > 
< email> 
< label > 电子 邮件 </label > 
< controller personal </controller > 
<action> email </action> 
</email > 
< addresslist > 
< label > 通讯 录 </label > 
< controller personal </controller > 
« action» address </action> 
«/addresslist > 
< instruction» 
< label > 常用 批示 </label > 
< controller > personalapp </controller > 
<action> instruct </action> 
</instruction> 
< personalinfo> 
< label > 个 人 名 片 </label > 
<controller > personal </controller > 
<action> personalinfo </action> 
</personalinfo> 
</pages> 
</personal > 
<publicservice> 
< label > 公共 服务 </label> 
<controller > pubservice </controller > 
<action> index </action> 
<pages> 
<publicview> 
< label > 公共 浏览 </label > 
< controller > pubservice </controller > 
<action> pubview </action> 
</publicview> 
<govopen> 
< label > 政务 公开 </label> 
< controller > pubservice </controller > 
< action > govopen </action> 
«/govopen > 
< storage > 


< label > 网 络 存储 </label > 


< controller > pubservice </controller> 
< action» storage </action> 

</storage> 

< download > 
< label > 资料 下 载 </label > 
< controller > pubservice </controller > 
< action > download </action > 

</download > 

< express > 
< label > 快递 查询 </label > 
< controller > pubservice «/controller > 
< action» express </action> 

</express > 

</pages > 
</publicservice> 
</configdata > 


以 上 XML 文件 定义 了 company, home, document , meeting, office, personal, publicservice 共 
7 个 标签 ,它们 将 成 为 一 级 导航 菜单 ,然后 在 document 下 创建 了 一 个 名 为 pages 的 标签 ,其 
中 又 包含 了 issue、receive、interfile 4 个 标签 ,它们 将 成 为 document 下 的 二 级 导航 菜单 。 在 
每 一 个 标签 中 都 定义 了 lable controller 及 action ,它们 将 分 别 成 为 菜单 名 称 和 菜单 所 指向 
的 链接 页 面 。 
5.1.2 初始 化 Zend Navigation 组 件 


TE Zend Studio 集成 开发 环境 中 打开 application Bootstrap. php 启动 文件 ,在 Bootstrap 类 
中 添加 _initNavigation() 初 始 化 函数 ,并 编写 如 下 代码 : 


class Bootstrap extends Zend Application Bootstrap Bootstrap 
{ 


protected function initNavigation() 
( 
$ this -> bootstrap( layout'); 
$ layout = $ this -> getResource( 'layout'); 
$ view- $ layout - » getView(); 
$ config = new Zend Config Xml( 
APPLICATION PATRH. '/configs/navigation. xml'); 
$ navigation = new Zend Navigation( $ config); 
$ view - > navigation( $ navigation); 


) 


上 述 代码 分 4 个 步骤 创建 页 面 导航 。 首 先 分别 调 用 Bootstrap 类 的 bootstrap() 方 法 和 
getResource() 方 法 ,启用 layout 布局 模板 并 获取 模板 对 象 ; 然后 调用 Zend Layout 类 的 
getView() 方 法 ,得 到 视图 对 象 ; 接 下 来 实例 化 一 个 Zend_Config_Xml 对 象 ,在 实例 化 时 使 
用 前 面 创建 的 navigation. xml 文件 的 路 径 字 符 串 作为 参数 , 读 取 navigation. xml 中 的 配置， 
紧 接 着 实例 化 一 个 Zend_Navigation 对 象 .并 将 对 象 config 作为 参数 读 入 其 中 ; 最 后 将 对 象 
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Navigation 添加 到 View 视图 中 ,这 样 应 用 程序 在 这 染 layout 视图 模板 页 面 时 就 会 调用 
navigation. xml 文件 中 定义 的 标签 生成 导航 菜单 。 


5.1.3 显示 导航 菜单 


1. 输出 导航 菜单 
在 layout 布局 模板 视图 的 主 显示 区 顶部 泻 染 输 出 导航 菜单 。 在 模板 文件 applicationV 
layouts\layout. phtml 中 添加 代码 : 


<body> 

<div id= "wrap"> 

<?php echo $ this -> partial('header.phtnl'); ?> 

<div id = "nav"><?php echo $ this -> navigation() -> menu(); ?></div> 

</body> 

这 一 行 代码 很 简单 ,直接 用 echo 输出 在 Bootstrap 启动 文件 中 配置 的 navigation 资源 ， 
菜单 效果 如 图 5. 1 所 示 。 


图 5.1 资源 


2. 输出 面包 居 导 航 

面包 习 导 航 (Breadcrumb Navigation) 这 个 概念 来 自 童 话 故 事 “ 汉 赛 尔 和 格 莱特 ”, 当 汉 
赛 尔 和 格 莱特 穿 过 森林 时 ,不 小 心 迷 路 了 ,但 是 他 们 发 现在 沿途 走 过 的 地 方 都 撤 下 了 面包 
眉 , 这 些 面包 丑 帮 助 他 们 找到 了 回 家 的 路 。 所 以 ,面包 习 导 航 就 是 告诉 用 户 目前 在 系统 中 的 
位 置 以 及 如 何 返回 的 一 种 技术 方案 。 

打开 模板 文件 applicationMayoutsMayout. phtml, 在 页 面 中 添加 代码 : 


< body» 
<div id= "wrap" 
<?php echo $ this -> partial( 'header. phtml'); ?> 
<div id= "breadnav"> 
< span > 您 目前 的 位 置 : </span ><?php echo $ this -> navigation() -> 
breadcrumbs() - > setLinkLast(false) -> setMinDepth(0) -> render(); ?> 
</div> 
<div id = "nav"><?php echo $ this -> navigation() -> menu(); ?></div> 


</body> 


其 中 的 setLinkLast() 方 法 定义 导航 的 最 后 一 项 是 否 有 链接 ,其 参数 是 false 或 true; 


setMinDepth 是 导航 出 现 的 页 面 层级 ,设置 为 1, 表示 只 在 一 级 分 类 页 面 以 下 的 页 面 显示 ; 
如 果 设 置 为 0, 则 在 首页 中 也 会 显示 面包 悄 ,如 图 5. 2 所 示 。 


您 目前 的 位 置 : 公文 管理 > 发文 管理 公司 主页 首页 公文 管理 会 议 管理 


View script for controller Document acd scrip! action came issue. 


5.2 面包 屑 导航 效果 


该 图 中 上 部 显示 的 “公文 管理 ”1“ 发 文 管理 ” 即 为 面包 悄 导 航 , 它 是 用 户 选 择 “ 公 文 管理 ” 
下 的 “发 文 管理 ”菜单 项 后 显示 的 效果 ,说 明 用 户 现在 位 于 系统 的 “发 文 管理 ”信息 显示 页 面 
位 置 。 当 系统 页 面 层级 较 多 时 ,能 够 让 用 户 非常 清楚 地 知道 自己 目前 的 位 置 ,并 能 快速 地 返 
回 到 上 一 级 页 面 。 


5.2 Zend_Navigation 组 件 


上 面 演 示 了 Zend Framework 的 Zend_Navigation 组 件 的 功能 及 使 用 方法 ,下面 简单 分 
析 一 下 原理 ,以 使 大 家 在 使 用 时 能 够 更 加 灵活 。 
从 上 面 的 实例 可 以 看 出 ,导航 菜单 的 创建 是 在 Bootstrap 启动 文件 中 通过 加 载 navigation. 
xml 文件 完成 的 。 所 谓 的 “导航 菜单 ”, 实 际 上 就 是 一 个 Zend_Navigation 类 的 实例 。 
打开 Zend Framework 库 文件 中 Zend. Navigation 类 的 定义 文件 ,其 源 代码 如 下 : 
class Zend Navigation extends Zend Navigation Container 
{ 
public function — construct( $ pages = null) 
{ 
if (is_array( $ pages) || $ pages instanceof Zend Config) { 
$ this -> addPages( $ pages); 
} elseif (null !== $ pages) { 
require_once 'Zend/Navigation/Exception. php'; 
throw new Zend_Navigation_Exception( 
'Invalid argument: $ pages must be an array,an '. 
'instance of Zend Config, or null'); 


} 

可 以 看 出 ,Zend_Navigation 类 继承 于 类 Zend_Navigation_Container, 实 例 化 时 需要 带 
一 个 参数 pages。 从 接 下 来 的 让 请 句 可 知 ,pages 参数 既 可 以 是 Zend Config 类 实例 ,还 可 
以 是 数组 。 上 面 创建 的 navigation. xml 便 属于 Zend_Config 实例 ,当然 ,这 个 XML 文件 也 
可 以 用 INI 配置 文件 的 形式 ,就 像 应 用 程序 的 application. ini 一 样 。 


5.2.1 Zend Navigation Page 类 


实际 上 ,创建 Zend_ Navigation 实例 时 带 进 的 参数 pages 是 Zend. Navigation 的 一 个 
Zend Navigation Page 对 象 。Zend_Navigation_Page 类 有 两 个 子 类 , 即 Zend Navigation | 


H FA Zend Db Jt IE E 


第 
5 
章 


PHP Zend Framework 5 A FEŻ s RUHE 


Page Mvc 和 Zend_Navigation_Page_Uri, 它 们 分 别 对 应 MVC page 和 URI page 两 种 页 面 类 型 。 
1. 页 面 的 通用 属性 
Zend Navigation 导航 菜单 中 所 指向 的 页 面 不 管 是 哪 种 类 型 都 具有 如 下 公共 属性 。 
* label: 链接 标签 ; 
-° id: 链接 ID; 
。 class: 类 样式 ; 
。 title: 窗口 标题 ; 
* target; 窗口 类 型 。 
上 面 只 列 出 了 部 分 属性 ,更 多 属性 请 参考 Zend Framework 使 用 手册 。 这 些 属性 实际 
上 就 是 HTML 中 所 a> 标 签 中 的 属性 ,对 于 它们 的 含义 大 家 都 比较 熟悉 ,这 里 不 再 袭 述 。 
2. MVC pages 
MVC pages 是 定义 于 Zend. Controller MVC 模式 下 的 一 种 页 面 类 型 ,通过 Zend. Navigation | 
Page Mvc 类 创建 , 它 除 了 具有 上 面 的 公共 属性 之 外 ,还 具有 符合 MVC 路 由 特点 的 一 些 属性 。 
。 Action :页 面 所 属 的 方法 名 ; 
* Controller: 页 面 所 属 的 控制 器 名 ; 
* Module; 页 面 所 属 的 模块 名 ; 
。 Params: URI 中 的 附加 参数 。 
分 析 一 下 前 面 用 XML 文件 定义 的 每 个 菜单 项 .例如 “首页 "菜单 项 : 
< home> 
< label > 首页 </label > 
< controller > index </controller> 


< action» main </action> 
</home> 


可 以 发 现 , 设 置 了 action 和 controller 属性 值 。 很 明显 ,这 些 菜单 所 指向 的 页 面 都 属于 
MVC pages 页 面 , 它 的 转向 符合 MVC 模式 规则 。 
用 户 还 可 以 用 如 下 形式 创建 MVC pages: 


// 菜 单 “ 首 页 ”指向 /index/main 页 面 

$ mainpage = new Zend_Navigation Page Mvc(array( 
'label' -» HJ, 
'action' => 'index', 
'controller' => 'main' 


)); 


// 菜 单 "ZendBog" 指 向 /blog/post/view/id/1337 页 面 
$ page = new Zend Navigation Page Mvc(array( 
"label' => "ZendBog', 
'action' => 'view', 
'controller'-» 'post', 
'module" => 'blog', 
'params" => array('id'-» 1337) 


3. URI pages 
上 面 的 MVC pages 页 面 指向 的 是 应 用 内 部 ,而 URI pages 能 让 菜单 指向 应 用 外 的 某 个 
链接 ,除了 上 面 的 公共 属性 外 . 它 只 有 uri 一 个 特有 属性 ,用 来 指明 链接 地 址 。 
$ page = Zend Navigation Page Uri (array( 
label'z» "百度 '， 
"uri' => 'http://www. baidu. com/' 
»; 
4. 效果 测试 


将 上 述 2、3 中 的 代码 添加 到 引导 文件 Bootstrap. EE 
php 中 进行 测试 ,效果 如 图 5. 3 所 示 。 


Bs M7: Hs d FUR 


protected function initNavigation() 
{ 
$ this - > bootstrap( layout'); 
$ layout = $ this - > getResource( 'layout'); 5.3 菜单 导航 示例 效果 
$ view- $ layout - > getView(); 


// 菜 单 “ 首 页 ”指向 / index/maind 页 面 
$ mainpage = new Zend Navigation Page Mvc(array( 
"label' | -» ' 首 页 '， 
'action' => 'index', 
'controller'-» 'main' 
); 
// 菜 单 "ZendBog" 指 向 /blog/post/view/id/1337 页 面 
$ pagel = new Zend Navigation Page Mvc(array( 
"abel! => 'ZendBog', 


'action' => 'view', 
'controller'-» 'post', 
"module" => 'blog', 
'params' => array('id'-» 1337) 


); 
$ page2 = new Zend Navigation Page Uri (array( 
'label'=> ' 百 度 ， 
"uri' => 'http://www. baidu. com/" 
); 
$ navigation = new Zend Navigation(); 
$ navigation - > addPages(array( $ mainpage, $ pagel, $ page2)); 
$ view - > navigation( $ navigation); 


) 

观察 菜单 效果 时 ,请 注意 将 鼠标 指针 移动 到 某 菜单 项 时 浏览 器 状态 栏 上 显示 的 链接 
地 址 。 
5.2.2 Zend Navigation Container 类 


从 Zend. Navigation 2E fij zE X. n[ il. Zend Navigation Container 类 是 其 父 类 。 也 就 是 
说 ,我 们 创建 的 导航 菜单 同样 是 一 个 Zend Navigation Container 类 的 实例 。 除 了 可 以 使 用 
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配置 文件 创建 Zend Navigation Container 实例 外 ,还 可 以 使 用 数组 创建 Zend. Navigation | 
Container 实例 ,例如 : 


$ container = new Zend Navigation(array( 
array( 
"abel'=> "百度 '， 
'uri'=> 'http://www. baidu. com/' 
) 
array( 
"abel'=> ' 新 闻 动态 '， 
'controller' => "news', 
'pages' => array( 
array( 
'label'=> "EE, 
'action'=> 'unvnews', 
'controller'=> 'news' 
)» 
array( 
"label's» ' 学 院 新 闻 '， 
'action' => 'colnews', 
'controller'=> 'news' 


) 


) 

); 

fit FH ZE KY 75 C n E FASE E «DA A LE E A E AS H ES JE CEA il A n DT TA ox b BE A 
URL 的 正确 性 。 上 面 代码 创建 的 菜单 效果 如 图 5. 4 


所 示 。 a—À on REI 一 | 
上 面 只 是 简单 地 介绍 了 导航 菜单 的 不 同 创建 方 ”| 四 


式 , 其 实在 上 面 提 到 的 几 个 类 中 封装 了 非常 多 的 方 

法 ,使 用 这 些 方法 可 以 动态 地 对 导航 菜单 进行 控制 ， 图 5.4 用 数组 方式 创建 的 导航 菜单 效果 
例如 增加 菜单 项 、 删 除 菜 单项 、 修 改革 单项 的 属性 

等 ,真正 做 到 应 用 自如 。 


5.3 新 闻 资 讯 页 面 的 实现 


系统 的 设计 过 程 实际 上 就 是 系统 中 信息 的 存储 、 处 理 与 显示 的 过 程 。 信 息 的 存储 有 多 
种 方式 ,例如 数据 库 、 文 件 等 ,应 根据 系统 中 信息 的 具体 使 用 情况 进行 选用 ; 信息 的 处 理 包 
括 信 息 的 增加 、 删 除 、 修 改 ,查询 以 及 合并 等 ,是 对 文件 或 数据 库 的 一 系列 操作 ; 信息 的 显示 
是 对 信息 处 理 结 果 的 呈现 ,呈现 方式 可 以 是 文本 、 图 形 以 及 表格 等 多 种 形式 。 

Zend Framework 项 目 所 采用 的 MVC 模式 正好 契合 了 系统 设计 的 这 个 过 程 。 下 面 以 
系统 中 新 闻 文章 页 面 的 实现 为 例 , 详 细 介 绍 Zend Framework 中 模型 的 创建 ,数据 库 的 操作 
以 及 页 面 输出 的 控制 方法 。 


S.3.1 创建 数据 库 


数据 库 的 创建 有 多 种 方式 ,可 以 通过 命令 的 方式 在 MySQL 控制 台中 创建 ,也 可 以 使 用 
MySQL 的 管理 工具 创建 ,不 管 采用 什么 方式 ,首先 都 必须 启动 MySQL 数据 库 服 务 器 。 

1. 启动 数据 库 服 务 

打开 XAMPP 控制 面板 , 单 击 MySQL 对 应 的 Start 按钮 ,启动 MySQL 数据 库 服务 器 。 
如 果 控 制 面板 下 面 的 信息 显示 框 中 不 出 现 红色 的 错误 信息 , 则 说 明 数 据 库 服务 启动 成 功 ,如 
图 5.5 所 示 。 


XAMPP Control Panel v3.2.1 
PID(s) Ports) Actions 
E 80,443. [ Stop. 
2512 3306 

[Sn | 
[stan] [ Admin 
[san | 


9 [nain] Checking for prerequisites 
[nain] All prerequisites found 
[nain] Initializing Modules 
[nain] Starting Check-Timer 
[nain] Control Panel Ready 
[Apache] Attempting to start Apache app... 
[Apache] Status change detected: running 
ô [mysql] Attempting to start MySQL app... 
[mysql] Status change detected: running 


图 5.5 数据 库 服务 器 的 启动 

2. 创建 数据 库 

D 使 用 MySQL 控制 台 

打开 操作 系统 命令 窗口 ,输入 以 下 连接 MySQL 服务 器 的 命令 并 回 车 ,接着 输入 密码 ， 
即 可 进入 MySQL 命令 提示 状态 ,如 图 5.6 所 示 。 

mysql -h localhost -u root -p 

其 中 ,-h 为 所 连接 的 数据 库 服务 器 位 置 , 可 以 是 IP 地 址 ,也 可 以 是 服务 器 的 域名 ,这 里 
为 localhost 或 127. 0. 0. 1; -u 为 连接 数据 库 服务 器 使 用 的 用 户 名 ,这 里 为 root; -p 为 连接 
数据 库 服 务 器 使 用 的 密码 。 

在 如 图 5.6 所 示 的 MySQL 控制 台中 输入 如 下 命令 ,创建 名 为 db_wmoams 的 数据 库 。 


create database db wmoams; 
使 用 命令 : 
Show databases; 


查看 数据 库 服 务 器 中 已 创建 的 数据 库 , 如 果 在 数据 库 列 表 中 能 看 到 db_wmoams, 说 明 数据 
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版 本 6.1.76081 s 
所 有 <c> 2889 Microsoft Corporation。 保 留 所 


dninistrator nysql -h localhost -u root -p 
[Enter passuord: xe 
Welcome to the MySQL monitor. Commands end with ; or \g- 
Vour MySQL connection id is 2 
[Server version: 5.6.16 MySQL Community Server (GPL) 


[Copyright <c> 2080, 2011, Oracle and/or its affiliates. All rights reserved. 


a registered trademark of Oracle Corporation and/or its 
Other names may be tradenarks of their respective 


Type 'help;' or '*h' for help. Type ’\c’ to clear the current input statenent. 


Inysql> 


图 5.6 MySQL 数据 库 命令 窗口 


库 创 建成 功 。 
2) 使 用 phpMyAdmin 数据 库 管 理工 具 
依照 第 1 章 中 介绍 的 方法 打开 phpMyAdmin MySQL 数据 库 管 理 器 , 单 击 窗口 左 侧 的 
New 选项 或 选择 窗口 右 侧 的 “数据 库 ? 莱 单项 ,打开 新 建 数据 库 窗 口 ,输入 数据 库 名 , 单 击 
“创建 "按钮 , 即 可 完成 数据 库 的 创建 ,如 区 


i localhost / 37001 | phpMyhdmin 41.12 a-o- 


phpMyAdmin 
全 到 BBD 
(emos) n 
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3. 创建 数据 表 


打开 phpMyAdmin 数据 库 管理 器 ,找到 数据 库 db_wmoams, 在 其 中 建立 名 为 tb_news 
的 数据 表 ,或 者 用 以 下 命令 在 MySQL 控制 台中 创建 。 


CREATE TABLE IF NOT EXISTS 'tb news'( 
'id' int(10) unsigned NOT NULL AUTO INCREMENT, 
'cid' int(10) unsigned NOT NULL DEFAULT '0', 
'uid'int(10) unsigned NOT NULL DEFAULT '0', 
'title'varchar(255) NOT NULL, 
"body' text NOT NULL, 
'type'varchar(50) CHARACTER SET utf8 COLLATE utf8 unicode ci NOT NULL, 
'status'tinyint(4) NOT NULL DEFAULT '1', 
'createtime' int(11) NOT NULL DEFAULT '0', 
'updatetime' int(11) NOT NULL DEFAULT '0', 
'comment'tinyint(4) NOT NULL DEFAULT '0', 
'star'tinyint(4) NOT NULL DEFAULT '0', 
"'top'tinyint(4) NOT NULL DEFAULT '0', 
PRIMARY KEY ('id') 

) ENGINE = MyISAM DEFAULT CHARSET = utf8; 


5.3.2. 数据 库 的 配置 


在 数据 库 创建 好 之 后 ,需要 对 Zend Framework 框架 进行 相应 配置 ,让 框架 能 与 数据 库 
连接 ,这 样 它 才 能 真正 地 开始 为 我 们 服务 。 

1. 直接 修改 application. ini 配置 文件 

打开 applicationNconfigsVapplication. ini 配置 文件 ,并 添加 如 下 代码 : 


[development : production] 

phpSettings.display startup errors- 1 
phpSettings.display errors = 1 

resources. frontController. params.displayExceptions = 1 


; 数据 库 

resources. db. adapter = "PDO MYSQL" 

resources. db. params. host = "localhost" 

resources. db. params. username = "root" 

resources. db. params. password = "wnstudio" 

resources. db. params. dbname = "db wnoams" 

resources. db. params. charset - "utf8" 

resources. db. isDefaultTableAdapter - true 

resources. db. params. driver_options. 1002 = "SET NAMES UTF8" 


代码 中 的 第 1 行 声明 数据 库 适 配器 为 PDO_MYSQL, Zend Framework 提供 了 一 个 
PDO 数据 库 层 ,可 以 支持 包括 Oracle, MySQL, SQLite, Microsoft SQL Server, PostgreSQL, IBM 
DB2 等 在 内 的 多 种 数据 库 。 

当 使 用 这 些 数据 库 时 ,只 需 在 配置 文件 中 指定 数据 库 适 配器 即 可 ,以 后 如 果 要 更 换 数据 
库 , 也 只 需 更 改 配置 文件 ,无 须 改动 程序 代码 。 这 里 使 用 MySQL 数据 库 , 所 以 配置 的 是 
PDO_MYSQL 适配器 。 如 果 使 用 其 他 类 型 的 数据 库 ,将 PDO_MYSQL 中 的 MYSQL 换 成 
相应 的 数据 库 类 型 就 可 以 了 。 

接 下 来 的 5 行 分 别 配置 了 数据 库 服 务 器 (localhost) 使 用 数据 库 的 用 户 (root) 和 密码 
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(wmstudio) 数据 库 名 称 (db_wmoams) 以 及 数据 库 编 码 方式 (utf8) 。 

第 6 行 指定 适配器 为 项 目的 默认 数据 库 适 配器 ,这 样 如 果 在 项 目 中 使 用 了 不 止 一 个 数 
据 库 , 则 调用 DefaultTableAdapter 即 可 方便 地 使 用 本 数据 库 。 

最 后 1 行 配置 可 以 使 数据 在 页 面 、 表 单间 输入 与 输出 都 以 utf8 的 编码 方式 进行 。 需 要 
注意 的 是 ,如 果 添 加 了 这 条 配置 ,应 确保 项 目 中 所 有 页 面 的 编码 方式 也 是 utf8, 以 防 出 现 
乱码 。 

2. 使 用 ZF Tool 工具 配置 

打开 Zend Studio 集成 开发 环境 ,定位 到 工作 区 的 项 目 wmProject 中 ,然后 选择 Project 
|Zend Tool 菜单 项 ,打开 Zend Tool 工具 命令 窗口 ,输入 以 下 命令 : 

Zf configure db- adapter 

"adapter = PDO  MYSQL&host = localhost&username = root&password = wmstudio&dbname = db _ 

wmoams&charset = utf8 " development 

命令 行 的 结尾 使 用 development 表示 数据 库 的 配置 放置 在 application. ini 文件 的 
develpment 小 节 中 。 

注意 以 下 两 行 配置 无 法 通过 Zend Tool 工具 创建 ,需要 手工 添加 。 


resources. db. isDefaultTableAdapter = true 
resources. db. params. driver_options. 1002 = "SET NAMES UTF8" 


5.3.3 修改 项 目 命名 空间 


Zend Framework 中 的 类 名 具有 特定 的 命名 规则 。 如 果 严 格 按照 这 种 规则 命名 类 ,在 
项 目 中 创建 类 的 实例 时 就 不 用 通过 include, require 等 方式 引用 类 的 定义 ,给 编程 带 来 极 大 
的 方便 。 

在 Zend Framework 中 搜索 某 个 类 的 定义 时 是 从 application. 目录 开始 逐步 向 里 进行 
的 ,所 以 ,如 果 类 名 能 够 表示 该 类 定义 文件 的 路 径 ,系统 就 可 以 自动 进行 搜索 。 例 如 ,如 果 要 
在 项 目 中 定义 一 个 News 类 ,该 类 的 定义 代码 存放 在 application\models\ News. php 文件 
中 ,就 可 以 命名 该 类 为 Application_Model_News。 从 这 里 可 以 看 出 ,应 用 的 默认 命名 空间 
前 级 为 Application_, 这 一 点 也 可 以 在 application\configs\application. ini 中 找到 相应 的 定 
义 代 码 appnamespace 王 "Application" 得 到 印证 。 使 用 这 个 默认 前 组 不 是 很 方便 ,有 必要 对 
它 进行 修改 。 

更 改 Zend Framework 应 用 程序 的 命名 空间 有 下 面 两 种 方法 。 

1. 直接 修改 代码 

COD 打开 项 目 根 目录 中 的 . zfproject. xml 文件 ,找到 如 下 代码 ; 


<applicationDirectory classNamePrefix = "Application "> 
将 其 修改 为 : 
«applicationDirectory classNamePrefix = "Wm "> 


其 中 ,Wm_ 是 自 定义 的 命名 空间 前 级 。zfproject. xml 文件 是 Zend Tool 工具 的 配置 文 
件 ,classNamePrefix( 类 名 前 缀 ) 预 定义 了 将 要 创建 的 控制 器 ,模型 .表单 等 的 类 名 前 级 。 


(2) 打开 application\configs\application. ini 文件 ,找到 如 下 代码 : 
appnamespace = "Application" 

将 其 修改 为 : 
appnamespace = "Wm_" 


2. 用 ZF Tool 命令 工具 修改 
在 Zend Studio 集成 开发 环境 中 打开 Zend Tool 工具 命令 窗口 ,输入 命令 : 


Zf change application. class - name - prefix Wm 


即 可 自动 完成 上 述 1 中 的 两 处 代码 修改 。 
5.3.4 创建 模型 与 方法 


对 于 Zend Framework 的 MVC 模式 ,我 们 已 经 用 到 了 V 和 C, 即 视图 与 控制 器 。 下 面 
针对 系统 中 的 “新 闻 文 章 ” 这 类 信息 编写 处 理 它们 的 业务 逻辑 ( 即 模型 ) 来 实现 对 信息 的 一 系 
列 操作 。 

1. 创建 模型 

打开 Zend Studio 集成 开发 环境 ,定位 到 工作 区 的 项 目 wmProject 中 ,选择 Project | 
Zend Tool 菜单 项 ,打开 Zend Tool 工具 命令 窗口 ,输入 命令 : 


Zf create model News 


创建 一 个 名 为 News 的 模型 。 若 命令 执行 成 功 ,Zend Tool 工具 会 在 项 目的 application A 
录 下 新 建 一 个 名 为 models 的 文件 夹 ,并 在 这 个 文件 夹 中 创建 一 个 名 为 News. php 的 文件 ， 
该 文件 定义 了 一 个 名 为 Wm Model News 的 类 。 为 了 使 用 Zend Framework 的 Zend Db 
组 件 对 数据 库 进 行 操作 ,需要 给 这 个 类 添加 一 个 名 为 Zend_Db_Table 的 基 类 ,并 添加 对 应 
的 数据 库 表 名 。 代 码 如 下 : 

class Wm Model News extends Zend Db Table 

l 

// 定 义 模型 数据 表 


protected $ name- 'tb news'; 


) 


模型 类 Wm Model News 继承 Zend Db Table 类 后 , 便 成 为 Zend Framework 的 表 模 
型 ,拥有 了 对 数据 库 操作 的 权限 。 代 码 中 的 变量 _name 为 表 模 型 中 的 特定 变量 ,代表 该 表 模 
型 对 应 的 数据 表 。 

2. 创建 方法 

为 Wm_Model_News 类 添加 一 个 名 为 getNews 的 方法 ,用 于 从 数据 库 中 读 取 一 条 新 闻 
信息 。 代 码 如 下 : 

class Wm Model News extends Zend Db Table 

{ 


protected $ name- 'tb news'; 
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public function getNews( $ where = null, $ order = null)( 
if(is numeric( $ where) )( 
$ row- $ this—- » find( $ where) - » current(); 
}else{ 
$ row= $ this -> fetchRow( $ where, $ order); 
) 
if ( $ row) { 
return $ row; 
}else { 
return null; 
} 
) 


5.3.5 实现 新 闻 文 章 的 显示 


1. 创建 控制 器 
打开 Zend Studio 集成 开发 环境 ,定位 到 工作 区 的 项 目 wmProject 中 ,选择 Project | 
Zend Tool 菜单 项 ,打开 ZF Tool 工具 命令 窗口 ,输入 命令 : 


Zf create controller News 


在 默认 模块 default 中 创建 一 个 名 为 News 的 控制 器 。 在 News 控制 器 的 index 方法 中 添加 
以 下 代码 : 


class NewsController extends Zend Controller Action 
{ 

public function init() 

( 


/ * Initialize action controller here * / 


) 
public function indexAction() 
t 
$ modelNews - new Wn Model News(); // 实 例 化 模型 对 象 
$ where = array('top' =>1); // 定 义 查 询 条 件 
$ newsTop = $ modelNews 一 > getNews( $ where); // 获 取 新 闻 文章 
$ this—>view—> newsTop = $ newsTop; // 输 出 到 视图 
} 
} 
上 面 的 代码 中 设置 的 查询 条 件 是 “置顶 于 新 闻 文 章 的 第 1 篇 ”。 
2. 修改 视图 


打开 News 控制 器 的 index 方法 对 应 的 视图 文件 application V views \ scripts \ news \ 
index. phtml, 将 其 修改 为 : 


<br /><br /> 
<?php 
if( $ this -> newsTop)( 
echo "< h3 >". $ this - » newsTop[ 'title']."«/h3»"; 
echo "发 布 日 期 : ".date("Y-m-d : H- i-s", $ this -> newsTop[ 'createtime']). 
be 
echo $ this -> newsTop[ 'body']; 
]else 
echo "< h3 >ik, Et 48 269] 598 de d RE DE CE n3 ><hr />"; 


?> 


3. 显示 新 闻 

用 phpMyAdmin 数据 库 管理 器 打开 数据 库 db_wmoams, 在 数据 表 tb. new. 中 添加 一 篇 
新 闻 文 章 , 设 置 top 为 1, 表示 该 篇 文章 需要 置顶 显示 。 

在 浏览 器 地 址 栏 中 输入 http://wmoams. com/news, 页 面 效果 如 图 5. 8 所 示 。 

大 家 可 以 在 数据 表 中 添加 不 同 的 新 闻 演 示 数 据 , 并 修改 News 控制 器 的 index 方法 中 
的 where 查询 条 件 ( 例 如 输入 数字 、 字 符 串 或 有 多 个 查询 条 件 的 数组 ) 测 试 页 面 的 显示 
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图 5.8 新 闻 文章 的 显示 


5.4 新 闻 的 列表 及 详细 显示 


5. 3 节 通 过 一 篇 新 闻 文 章 的 显示 介绍 了 MySQL 数据 库 的 设计 、MVC 模式 中 模型 的 构 
建 方法 以 及 通过 控制 器 使 用 模型 ,然后 输出 到 视图 的 全 过 程 。 相 信 大 家 对 Zend Framework 
框架 中 模型 (MD) 、 视 图 (V)、 控 制 器 (C) 三 者 之 间 的 关系 应 该 有 了 更 进一步 的 了 解 。 下 面 对 
模型 的 功能 进行 完善 与 扩充 ,使 其 能 从 数据 库 中 查询 到 多 篇 文章 ,并 以 列表 的 形式 在 视图 中 
显示 出 来 。 


S.4.1 新 闻 的 列表 显示 


1. 添加 模型 方法 

前 面 在 Wm Model News 模型 中 添加 getNews 方法 ,实现 了 对 某 类 新 闻 文 章 的 查询 。 
下 面 继续 在 该 模型 中 添加 方法 ,使 其 能 一 次 查询 到 多 篇 新 闻 文 章 。 

启动 Zend Studio 集成 开发 环境 ,打开 wmProject 项 目 中 的 application\models\ News. 
php 模型 文件 ,添加 getNewslist() 方 法 ,代码 如 下 : 
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public function getNewslist( $ where = null, $ order = null, $ limit = null) 
{ 
$ rowSet = $ this -> fetchAll( $ where, $ order, $ limit); 
if ( $ rowSet -> count()» 0) ( 
return $ rowSet; 
Jelse ( 
return null; 
} 
} 


2. 编写 控制 器 代码 
打开 News 控制 器 文件 application\controllers\ NewsController. php. Æ index() 方 法 
中 添加 代码 。 


public function indexAction() 
{ 


$ modelNews = new Wm Model News(); // 实 例 化 模型 对 象 
$ where = array( 'top' » 21); // 定 义 查 询 条 件 

$ newsTop = $ modelNews -» getNews( $ where); // 获 取 新 闻 文 章 

$ this -> view- » newsTop = $ newsTop; // 输 出 到 视图 


$ where = array( 'top' => 0); 
$ order = 'createtime DESC'; 


$ limit = 3; 
$ newsList = $ modelNews - > getNewslist( $ where, $ order, $ limit); 
$ this -> view- > newsList = $ newsList; // 输 出 到 视图 


3. 显示 新 闻 列 表 

在 News 控制 器 的 index() 方 法 中 调用 Wm. Model. News 模型 类 的 getNewslist() 方 法 
获取 满足 设 定 条 件 的 新 闻 文 章 列表 ,这 个 列表 是 一 个 Zend Db Table Rowset 类 对 象 , 它 是 
数据 库 记 录 的 集合 ,也 就 是 说 该 对 象 中 又 包含 了 许多 Zend Db Table Row 类 的 子 对 象 。 
为 了 输出 这 些 子 对 象 中 的 键 值 ,需要 采用 循环 的 方式 输出 。 

打开 视图 文件 application\views\scripts\news\index. phtml, 添 加 以 下 代码 : 


<br /><br /> 
<?php 
if( $ this - > newsTop)( 
echo "<h3>". $ this - » newsTop[ 'title']. "</h3>"; 
echo "发 布 日 期 : ".date("Y-m-d: H- i- s", $ this -> newsTop[ 'createtime']). 
"€ hr /2"; 
echo $ this -> newsTop[ 'body']. "< hr /»« br />"; 
Jelse 
echo "< h3 t fk , t 18 25 9] 9E e d SE DRE CE h3>< hr />"; 
echo "< h3 > 其 他 新 闻 </h3 >< hr />"; 
echo "< ul>" 
if( $ this -> newsList)( 
foreach ( $ this -> newsList as $ value){ 
echo "< li>". $ value[ 'title']."« 1 li>"; 
} 
echo "</ul>"; 


?> 


打开 浏览 器 进行 测试 ,效果 如 图 5. 9 所 示 。 
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图 5.9 新 闻 文 章 的 列表 显示 


4. 新 闻 列 表 显示 方式 的 改善 

使 用 Zend. View 的 partialLoop 视图 助手 代替 视图 中 的 foreach 输出 循环 能 够 减少 视 
图 页 面 中 的 PHP 代码 ,更 能 体现 面向 对 象 的 设计 理念 。 

修改 视图 文件 application\views\scripts\news\index. phtml 中 的 代码 : 


<?php 


echo "< h3 > 其 他 新 闻 </h3 >< hr />"; 

if( $ this- » newsList)( 
echo "< ul>"; 
echo $ this -> partialLoop( 'partials/row - pages. phtml', $ this -> newsList); 
echo "</ul>"; 


?> 


在 application\views\scripts 目录 下 新 建 partials 文件 夹 ,在 其 中 新 建 row-pages. phtml 
文件 ,添加 代码 : 


«li» 
<a href = " # "><?php echo $ this -> title; ?»«/a» 
< span > 发 布 时 间 : 
<?php echo date('Y-m- d: H- i-s', $ this-» createtime); ?> 
</span> 
</li> 
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在 浏览 器 中 测试 ,效果 如 图 5. 10 所 示 。 
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图 5.10 新 闻 文章 列表 显示 的 完善 


5.4.2 新 闻 的 详细 显示 


在 新 闻 首页 ,文章 标题 应 是 一 个 超级 链接 , 单 击 后 可 以 进入 文章 详细 页 面 ,显示 文章 的 
详细 信息 ,如 图 5. 10 所 示 。 图 中 所 展示 的 新 闻 首 页 分 为 两 部 分 ,上 部 分 为 置顶 显示 的 重要 
新 闻 , 下 部 分 是 其 他 新 闻 的 列表 ,我 们 给 每 个 新 闻 标 题 设置 了 超级 链接 , 接 下 来 实现 单 击 标 
题 ,进入 新 闻 文 章 详 细 页 面 的 功能 。 

1. 在 新 闻 首页 中 添加 链接 

新 闻 列 表 中 的 每 条 标题 都 是 一 个 超级 链接 ,因此 ,通过 单 击 标题 就 可 以 显示 该 篇 新 闻 的 
详细 内 容 。 为 了 在 数据 库 中 准确 地 查询 到 该 条 新 闻 记 录 , 需 要 通过 get 方法 将 新 闻 的 序号 
传递 给 模型 。 

打开 application\views\scripts\partials\row-pages. phtml 文件 ,给 a 标签 的 href 属性 
赋值 : 

«li» 

<a href = "/neus/detail/id/«?php echo $ this -» id ?>"> 
<?php echo $ this -> title; ?> 
</a> 
< span > 发 布 时 间 : 
<?php echo date('Y-m-d: H- i-s', $ this-» createtime); ?> 
</span> 
</li> 

代码 中 的 news detail 分 别 表示 控制 器 与 方法 ,id 是 我 们 自 定义 用 来 传递 新 闻 序号 的 参 
数 , 它 的 值 会 通过 get 方法 传递 到 detail 方法 中 。 

2. 创建 控制 器 方法 

打开 Zend Studio 集成 开发 环境 ,定位 到 工作 区 的 项 目 wmProject 中 ,选择 Project | 


Zend Tool 菜单 项 ,打开 Zend Tool 工具 命令 窗口 ,输入 命令 : 
Zf create action detail News 


TE News 控制 器 中 创建 detail 方法 。 打 开 application NVcontrollersN NewsController. php X: 
fF ,在 detailAction 方法 中 编写 代码 : 


public function detailAction() 
{ 
$ id= $ this - » getRequest() -> getParan( 'id'); 
$ modelNews = new Wn Model News(); 
$ news = $ nodelNews 一 > getNews( $ id); 
$ this -> view- » news = $ news; 


) 


代码 中 的 第 1 行 获取 newsNindex. phtml 视图 通过 get 方法 传递 的 URL 参数 id 的 值 ， 
然后 实例 化 一 个 新 闻 模 型 ,调用 模型 中 的 getNews 方法 ,从 数据 库 中 得 到 该 新 闻 的 记录 ,最 
后 将 得 到 的 记录 传递 到 视图 。 

3. 页 面 视图 设计 

在 创建 detail 方法 时 , Zend Framework 同时 创建 了 对 应 的 视图 detail. phtml, 它 位 于 
application\views\scripts\news 目录 下 。 打 开 该 文件 ,将 代码 改 为 : 

<br /><br /> 

<?php 

echo "<h2>". $ this -> news -> title. "</h2 >"; 

echo "< span > 发 表 于 : ".date('Y-m-d', $ this -> news - » createtime). "</span>"; 

echo "< span > 更 新 于 : ".date('Y-m-d', $ this -> news - » updatetime) . "</span>"; 

echo "« hr />"; 

echo $ this -> news - > body; 


完成 上 述 工作 后 ,在 浏览 器 中 输入 http://wmoams. com/news 访问 新 闻 主 页 ,然后 在 
新 闻 列 表 中 单 击 某 个 标题 , 即 可 看 到 该 新 闻 的 详细 内 容 , 如 图 5. 11 所 示 。 
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5.5 Zend Db 组 件 


Zend Db 是 Zend Framework 的 数据 库 操作 组 件 , 它 包括 Zend Db Adapter,Zend Db 
 Statement,Zend Db Profiler,Zend Db Select,Zend Db Table,Zend Db Table Row 以 
及 Zend Db Table Rowset 等 几 个 部 分 。 


5.5.1 Zend Db Adapter 类 


Zend Db Adapter 类 是 Zend Framework 的 数据 库 抽 象 层 API, 基 于 PDOCPHP Data 
Object, PHP 数据 对 象 扩 展 ), 可 以 使 用 它 连 接 和 处 理 多 种 数据 库 , 例 如 Microsoft SQL 
Server, MySQL 以 及 SQLite 等 。 

1. 创建 适配器 对 象 

用 户 可 以 通过 Zend Db 类 的 静态 方法 factory() 创 建 Zend. Db. Adapter 对 象 。 该 方法 
的 语法 格式 如 下 : 


Zend Db: :factory( $ adapter, $ config); 


其 中 ,参数 adapter 是 一 个 字符 串 变 量 ,表示 Zend. Db. Adapter 支持 的 数据 库 类 型 , 例 
如 DB2, MySQL, Oracle 数据 库 等 ,以 及 支持 使 用 PDO 的 类 型 ,例如 PDO_ Ibm, PDO_ 
Mssql,PDO Mysql, PDO Sgqlite 等 ; 参数 config 为 一 个 数组 型 变量 ,该 数组 为 连接 一 个 数 
据 库 必 须 配 置 的 内 容 ,就 像 前 面 在 application\configs\application. ini 文件 中 配置 的 那样 。 
例如 ,下 面 的 代码 实现 与 本 地 MySQL 数据 库 db. test 的 连接 。 
$ options = array( 
"host' -»'localhost', 
'username' = »'root', 
'password' = »'123456', 
'dbname' = »'db test' 
); 
$ db = Zend Db::factory('PDO MYSQL', $ options); 
2. 查询 记录 
在 创建 了 一 个 适配器 对 象 之 后 ,就 可 以 通过 它 对 数据 库 进行 查询 了 。 查 询 语句 可 以 直 
接 在 Zend_Db_Adapter 类 的 query 方法 中 编写 ,也 可 以 采用 Zend_Db_Select 对 象 。 例 如 : 
$ db = Zend_Db: :factory( 'PDO_MYSQL', $ option); 
$ result = $ db-»query('select * from tb user'); 
$ resultset- $ result -> fetchAll(); 


或 者 


$ db = Zend_Db: :factory('PDO_MYSQL', $ option); 
$ select = $ db- > select(); 

$ select -> from( 'tb_use', ' * '); 

$ resultset = $ db -> fetchAll( $ select); 


实际 使 用 时 ,需要 对 查询 语句 进行 无 害 化 处 理 , 即 对 语句 中 的 引号 进行 加 斜 线 处 理 , 以 


防止 数据 库 的 SQL 注入 攻击 ,此 时 使 用 Zend Db Adapter 类 的 quote 或 quoteInto 方法 。 
例如 : 


$ value= $ db—> quote("John's"); 
$value 的 值 已 变 成 : 
ohnN's' 
又 如 : 
$ result = $ db-»quoteInto('select * from tb test where id<?','5'); 


用 户 提供 一 个 包含 问号 占 位 符 的 基础 字符 串 ,然后 在 该 位 置 加 入 带 引号 的 标量 或 者 数 
组 。 在 使 用 quoteInto 方法 后 ,返回 一 个 安全 的 SQL 字符 串 。 例 如 : 


select * from db test where id < '5" 


3. 插 人 记录 

使 用 Zend Db Adapter 类 的 insert 方法 实现 数据 库 记 录 的 插入 。 为 了 方便 ,常常 使 用 
insert 方法 将 要 插入 的 数据 绑 定 ,并 创建 一 个 insert 语句 。 因 为 绑 定 的 数据 是 自动 进行 加 
引号 处 理 的 ,这 样 可 以 有 效 避 免 对 数据 库 的 攻击 。 其 语法 格式 如 下 : 


insert( $ table,array $ bind) 
使 用 示例 : 


$ user = array( 
'username' = »'weimeng', 
'password' = 2123456" 
$ 
$ table = tb_user; 
$ insert = $ db- » insert( $ table, $ user); 


注意 : insert 方法 的 返回 值 并 不 是 最 后 插入 记录 的 ID, 因为 在 一 些 表 中 并 没有 一 个 自 
增 的 字段 。 该 方法 的 返回 值 是 改变 记录 的 行 数 ,通常 为 1。 

4. 修改 记录 

通过 执行 Zend_Db_Adapter 类 的 update 方法 实现 数据 库 中 记录 的 修改 。 其 语法 格式 
Wb: 


update( $ table,array $ bind, $ where- '') 


其 中 ,参数 table 为 表 名 ; bind 为 修改 字段 与 内 容 构成 的 绑 定数 组 ;where 为 条 件 语 
句 。 示 例 代码 如 下 : 


$ table- tb user; 
$ user - array( 
'password' = »'abcdef ' 
H 
$ where = 'username = weimeng'; 
$ db- » update( $ table, $ user, $ where); 


d ow 
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5. 删除 记录 
通过 执行 Zend. Db. Adapter 类 的 delete 方法 实现 数据 库 中 记录 的 删除 。 其 语法 格式 
如 下 : 


delete( $ table, $ where- '') 


其 中 ,参数 table 为 表 名 ; where 为 删除 条 件 。 
5.5.2 Zend_Db_Table 类 


Zend_Db_Table 类 是 Zend Framework 的 表 模块 ,该 模块 通过 Zend Db Adapter 连接 
到 数据 库 ,为 数据 库 模 式 检查 表 对 象 , 并 对 该 表 执 行 查询 、 添 加 、 修 改 以 及 删除 等 操作 。 
Zend_Db_Table 类 为 抽象 类 ,所 以 不 能 直接 对 该 类 实例 化 ,只 能 先 继承 该 类 然后 实例 
化 子 类 。 首 先 需 要 设 定 一 个 默认 对 数据 库 的 适配器 ,如 果 不 再 指定 其 他 类 型 数据 库 适 配器 ， 
则 所 有 的 Zend Db. Table 类 实例 都 会 使 用 默认 的 适配器 。 
例如 ,本 童 案例 中 的 Wm Model News 模型 就 是 Zend_Db_Table 类 的 子 类 , 它 的 默认 
适配器 是 在 配置 文件 application\configs\application. in 中 以 资源 的 形式 定义 的 。 当 在 控 
制 器 的 方法 中 实例 化 该 模型 时 ,会 调用 该 类 的 基 类 Zend_Db_Table_Abstract 的 构造 方法 及 
_setup 方法 初始 化 数据 库 适 配器 。 
1. 表 名 及 主键 的 设置 
在 默认 情况 下 ,Zend_Db_Table 类 会 将 其 类 名 作为 数据 库 的 表 名 (大 小 写 不 同 的 地 方 
用 下 划 线 分 隔 ) 。 例 如 ,一 个 名 为 MyTableUser 的 Zend_Db_Table 类 将 自动 对 应 数据 库 中 
的 my table user 数据 表 。 若 要 修改 数据 表 名 ,将 该 类 的 _name 属性 重新 设置 即 可 ,就 像 我 
们 在 Wm Model News 类 中 做 的 那样 。 
Zend Db Table 类 的 默认 主键 为 id 字段 , 若 要 重新 设置 ,修改 其 属性 _primary。 例 如 ， 
若 要 将 案例 新 闻 表 中 的 createtime 字段 设置 为 类 的 查询 主键 ,添加 如 下 代码 : 
class Wm Model News extends Zend Db Table 
{ 
// 定 义 模型 数据 表 
protected $ name- 'tb news'; 
protected $ primary- 'createtime'; 
} 
2. 通过 主 健 查询 记录 
通过 调用 Zend_Db_Table 类 的 find 方法 可 以 直接 使 用 主键 值 查询 表 中 记录 。 例 如 
Wm. Model. News 类 的 方法 中 的 代码 : 


public function getNews( $ where = null, $ order = null)( 


if(is numeric( $ where) ){ 

$ row= $ this - » find( $ where) -> current() ; 
Jeise( 

$ row= $ this 一 > fetchRow( $ where, $ order); 
} 


Zend_Db_Table 类 的 find 方法 返回 一 个 Zend_Db_Table_Rowset 对 象 ,输出 时 要 进行 
相应 的 转换 。 另 外 , 带 入 find 方法 中 的 参数 可 以 是 数值 ,此 时 查询 一 条 记录 ; 也 可 以 是 数 
组 ,例如 array(1,5,10) ,表示 查询 主键 为 1、5、10 的 记录 , 共 3 条 。 

3. 通过 条 件 查询 记录 

虽然 使 用 find 方法 通过 主键 能 轻松 查询 到 数据 库 记 录 , 但 更 多 时 候 需 要 通过 条 件 查 
找 。Zend_Db_Table 类 提供 了 方法 fetchRow 和 fetchAll 实现 条 件 查 找 功 能 。 

使 用 fetchRow 方法 查找 一 条 记录 ,返回 一 个 Zend_Db_Table_Row 类 的 对 象 。 例 如 : 


public function getNews( $ where = null, $ order = null)( 


if(is numeric( $ where) ){ 
$ row- $this-» find( $ where) -> current(); 
Jelse( 


$ row= $ this -> fetchRow( $ where, $ order); 
) 


} 
使 用 fetchAll 方法 查找 多 条 记录 ,返回 一 个 Zend Db Table Rowset 类 的 对 象 。 例 如 : 


public function getNewslist( $ where = null, $ order = null, $ limit = null)( 
$ rowSet = $ this 一 > fetchAll( $ where, $ order, $ limit); 
if ( $ rowSet -> count()» 0) ( 
return $ rowSet; 
Jelse ( 
return null; 
) 
) 


5.5.3 Zend Db Select 类 


Zend Db Select 类 是 一 种 不 受 数 据 库 约束 构建 select 的 SQL 语句 的 工具 ,可 使 用 该 组 
件 生成 查询 的 SQL 语句 ,而 不 需要 考虑 各 种 数据 库 SQL 语句 的 差别 ,并 可 以 有 效 避 人 免 对 
SQL 语句 的 攻击 。 

1. 创建 实例 

创建 一 个 Zend Db Select 类 的 实例 ,使 用 Zend Db Adapter 的 select 方法 。 调 用 该 方 
法 不 需要 任何 参数 就 可 以 返回 一 个 Zend. Db. Select 实例 对 象 ,例如 : 

$ db = Zend Db: :factory('PDO MYSQL', $ option); 

$ select = $ db- » select(); 

2. 基本 查询 

指定 查询 表 名 及 条 件 后 ,就 可 以 通过 fetchAll 执行 查询 了 。 例 如 : 

$ db = Zend_Db: :factory( 'PDO_MYSQL', $ option); 

$ select = $ db-» select(); 

$ select -> from('tb use',' * '); 

$ resultset- $ db -> fetchAll( $ select); 
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上 面 的 代码 相当 于 执行 了 : 
select * from tb use 


查询 语句 。 

3. 条 件 查 询 

在 基本 查询 的 基础 上 ,通过 where 或 orWhere 方法 设置 查询 条 件 即 可 。 例 如 : 

$ db = Zend_Db: :factory( 'PDO_MYSQL', $ option); 

$ select = $ db-> select(); 

$ select -> from( 'tb_use', ' * '); 

$ select -> where( 'id<5'); 

$ resultset = $ db -> fetchAll( $ select); 

4. 查询 结果 的 排序 

使 用 Zend_Db_Select 类 的 order 方法 对 查询 返回 结果 集 按照 给 定 的 排序 规则 进行 排 
序 。 例 如 : 

$ db = Zend Db: :factory( 'PDO_MYSQL', $ option); 

$ select = $ db-» select(); 

$ select -> fron('tb use','* '); 

$ select -> where('id« 5"); 


$ select -> order( username ASC'); 
$ resultset = $ db - » fetchAll( $ select); 


s. 限制 查询 结果 数 

在 使 用 数据 库 查 询 的 结果 集 时 ,常常 需要 限制 结果 集 的 数量 ,这 个 功能 通过 调用 Zend_ 
Db_Select 类 的 limit 方法 实现 。 例 如 : 

$ db = Zend Db::factory('PDO MYSQL', $ option); 

$ select = $ db- » select(); 

$ select -> fron('tb use','* '); 

$ select -> where( 'id« 5"); 

$ select -> order( 'username ASC') ; 

$ select -> linit(2,3); 

$ resultset = $ db - » fetchAll( $ select); 

在 上 面 的 limit 方法 中 ,第 1 个 参数 “2" 表 示 取 两 条 记录 ; 第 2 个 参数 “3" 表 示 从 结果 集 
的 第 3 条 记录 开始 取 。 因 此 ,上 面 的 查询 执行 后 的 结果 是 获取 到 了 表 tb_user 中 序号 小 于 5 
的 所 有 记录 中 的 第 3、4 条 记录 。 


5.6 本 章 小 结 


章 主要 介绍 Zend Framework 应 用 的 导航 及 数据 库 操作 功能 。Zend Framework 的 
导航 由 Zend Navigation 组 件 完成 ,通过 该 组 件 不 仅 可 以 实现 多 级 导航 菜单 ,还 可 以 实现 页 
面 的 面包 习 导 航 功 能 。 但 使 用 Zend Navigation 组 件 稍 显 复杂 ,大 家 可 以 根据 实际 情况 选 
用 其 他 合适 的 解决 方案 ,例如 CSS、jQuery 等 。 

数据 库 操 作 是 Web 应 用 开发 的 关键 ,当然 也 是 本 章 的 重点 。Zend Framework 应 用 的 


数据 库 操 作 由 Zend Db 组 件 实现 ,该 组 件 提供 的 类 模块 功能 强大 、 兼 容 性 好 ,能够 充分 满足 
各 种 业务 逻辑 的 需要 。 本 章 通过 新 闻 资 讯 页 面 的 显示 实例 循序 渐进 .由浅 入 深 、 详 细 地 讲解 
了 Zend Framework 对 数据 库 的 操作 方法 ,包括 数据 库 的 配置 .模型 的 创建 以 及 查询 数据 在 
页 面 中 的 显示 等 。 在 介绍 新 知识 的 过 程 中 ,我 们 始终 围绕 MVC 模式 ,进一步 阐述 了 Zend 
Framework 框架 中 的 M( 模 型 )、V( 视 图 )、C( 控 制 器 ) 之 间 的 合作 关系 ,用 于 加 深 并 巩固 前 
面 章节 中 所 学 的 知识 。 
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第 6 章 注册 登录 及 Zend_Form 表单 


表单 是 Web 应 用 与 用 户 交互 的 窗口 ,同时 也 是 应 用 受到 外 来 攻击 的 入 口 。 因 此 ,表单 
的 设计 在 Web 应 用 中 显得 尤为 重要 ,关系 到 用 户 的 体验 、 数 据 的 准确 以 及 网 络 安全 等 各 个 


方面 。 
章 通过 用 户 注 册 与 登录 功能 的 实现 介绍 Zend Framework 的 Zend. Form 表单 的 创 


建 . 装 饰 及 使 用 方法 。 
6.1 登录 表单 设计 
在 第 4 章 中 已 经 创建 好 了 登录 页 面 , 但 没有 添加 登录 表单 ,下 面 通 过 创建 Zend 
Framework 表单 来 实现 系统 的 登录 功能 。 


6.1.1 登录 页 面 效果 
启动 Apache 服务 器 ,在 浏览 器 中 输入 http://wmoams. com, 进 入 系统 首页 。 单 击 页 
面 中 的 教材 名 称 图 片 , 即 可 进入 系统 用 户 登录 页 面 ,如 图 6. 1 所 示 。 


$ -|B|o|xjlgs eno p 


ü-HB-có- mo- etor IAQ- 图- " 


[TUS UTER 


微 林 软 件 - 登录 


ROIMAA 


图 6.1 用 户 登 录 页 面 效果 


如 果 在 图 6. 1 所 示 的 登录 页 面 中 直接 单 击 “ 登 录 ” 按 钮 , 则 会 出 现 如 图 6. 2 所 示 的 错误 
提示 页 面 。 
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图 6.2 用 户 登 录 错 误 信息 
可 以 看 到 ,由 于 在 登录 表单 中 没有 填写 任何 信息 ,页 面 右 侧 出 现 了 错误 提示 框 。 提 示 框 
中 的 错误 信息 是 在 登录 表单 类 中 设置 的 ,图 6.2 中 列 出 的 是 所 有 错误 提示 信息 。 


按 图 6. 2 提示 中 对 登录 名 的 要 求 输入 正确 的 登录 名 ,然后 单 击 * 登 录 ” 按 钮 ,出 现 如 
图 6. 3 所 示 的 密码 输入 错误 信息 。 


图 6.3 密码 输入 错误 信息 


这 里 给 出 的 是 对 两 个 密码 输入 框 中 的 数据 进行 验证 后 的 错误 提示 信息 , 若 表单 数据 不 
能 通过 验证 , 则 返回 登录 页 面 。 这 些 功能 都 是 使 用 Zend Framework 的 Zend Form 表单 自 
动 完 成 的 。 


6.1.2 Zend Form 表单 的 创建 


1. 创建 Zend_Form 表单 类 
启动 Zend Studio 集成 开发 环境 ,选择 工作 区 中 的 wmProject 项 目 . 打 开 ZF Tool 工具 
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命令 窗口 ,输入 命令 : 
Zf create form Login 


创建 一 个 名 为 Login 的 Zend Form 表单 。 
以 上 命令 自动 创建 application\forms\Login. php 表单 文件 ,其 中 的 forms 文件 夹 也 是 
ZF Tool 工具 自动 创建 的 。 打 开 文 件 会 看 到 表单 类 定义 的 一 些 初始 代码 ,如 下 所 示 : 


class Wm Form Login extends Zend Form 
{ 
public function init() 
{ 
/* Form Elements & Other Definitions Here ... * / 
) 
] 


从 上 面 的 代码 可 知 ,创建 的 表单 类 名 为 Wm_Form_Login, 该 名 称 符合 前 面 所 讲 的 
Zend Framework 类 名 的 命名 规则 ,使 用 该 类 时 可 以 自动 加 载 。 另 外 ,表单 类 继承 于 Zend 


Form 类 ,拥有 该 类 的 全 部 功能 。Zend_Form 类 位 于 Zend Framework 库 文 件 的 Zend 目录 
下 , 它 的 其 他 组 件 类 位 于 Zend\Form 目录 下 ,大 家 可 以 打开 源 文件 了 解 其 功能 。 

2. 添加 表单 元 素 

在 表单 类 Wm Form Login 的 init 方法 中 添加 代码 ,创建 表单 元 素 。 为 了 简单 ,这 里 只 
创建 用户”“ 密 码 ” 和 “提交 ”3 个 表单 元 素 , 其 他 (如 “验证 码 ” 等 ) 元 素 在 以 后 的 章节 中 介 
绍 。 代 码 如 下 : 


class Wm Form Login extends Zend Form 
{ 
public function init() 
{ 
// 表 单 属性 
$ this 一 > setName( 'form_login') 
一 > setMethod( 'post'); 
// 用 户 名 输入 文本 框 
$ userName = $ this -> createElement( text', 'username'); 
$ userName -> setLabel( ' 用 户 名 : '); 
$ userName — > setRequired( TRUE); 
$ userName - > addValidator( 'stringLength', false, array(5, 20)); 
$ userName - > addErrorMessage( ' 用 户 名 要 求 英文 5 - 20 个 字母 或 2-6 个 汉字 '); 
$ this -> addElement( $ userName) ; 
// 密 码 输入 框 
$ password = $ this -> createElement( 'password', 'password'); 
$ password -> setLabel( ' 密 码 : '); 
$ password - > setRequired(TRUE); 
$ password - > addValidator( 'stringLength',false,array(6)); 
$ password - > addErrorMessage( ' 密 码 要 求 至 少 6 个 字符 '); 
$ this- > addElement( $ password) ; 
// 提 交 按 钮 
$ submit = $ this - > createElement( 'submit', ' 提 交 '); 
$ this -> addElement( $ submit); 


由 于 Wm Form Login 表单 继承 于 Zend. Form 类 ,打开 Zend Framework 使 用 手册 或 
Zend Framework 库 文件 中 的 Zend_Form 类 源码 ,可 以 查询 其 全 部 方法 。 

在 上 述 代码 中 ,调用 Zend Form 类 的 setName,setMethod , createElement ,addElement 
方法 对 表单 对 象 的 名 称 .数据 提交 方法 进行 设置 ,并 完成 创建 与 添加 表单 元 素 的 操作 。 

代码 中 的 变量 userName, password 和 submit 分 别 为 “文本 框 >“ 密 码 框 ? 和 * 提 交 按 
钮 ?对 象 ,它们 分 别 属 于 Zend. Form. Element. Text, Zend. Form. Element. Password 和 
Zend Form. Element. Submit 类 的 表单 元 素 对 象 。 方 法 setLabel, setRequired, addValidator 和 
addErrorMessage 为 表单 元 素 对 象 的 方法 ,完成 表单 元 素 的 属性 、 验 证 器 以 及 验证 错误 信息 
的 设置 。 对 于 表单 元 素 方法 的 使 用 请 参考 相应 类 的 定义 或 Zend Framework 手册 。 

Zend. Form 表单 支持 的 表单 元 素 , 除 了 上 面 3 种 以 外 还 有 很 多 ,在 接 下 来 的 6. 2 节 中 
将 详细 介绍 。 

3. 显示 表单 

打开 控制 器 文件 application\ controllers\ User. php, Æ User 控制 器 的 login 方法 中 添 
加 如 下 代码 : 


class UserController extends Zend_Controller_Rction 
{ 


public function loginAction() 
{ 


$ formLogin = new Wm Form Login(); 
$ this -> view- » formLogin- $ formLogin; 


} 


在 login 方法 中 ,首先 创建 一 个 Wm_Form_Login 类 的 对 象 ,然后 将 该 对 象 赋 给 视图 对 
象 中 的 formLogin 变量 ,formLogin 是 自 定 义 变量 。 

从 前 面 的 分 析 可 知 ,控制 器 的 login 方法 对 应 的 视图 文件 是 application\views\scripts\ 
user\ login. phtml 文件 ,因此 ,只 需要 在 该 视图 对 象 中 把 表单 对 象 输出 即 可 显示 表单 。 

打开 User 控制 器 的 login 方法 对 应 的 视图 文件 login. phtml, 在 登录 区 的 右 侧 div 标签 
中 添加 如 下 代码 : 


<div id= "login center"> 
<div class = "left"> 
< img src = "<?php echo '/images/login center mark.gif'; ?>" /> 
</div> 
< div class = "center"></div > 
< div class = "right"><?php echo $ this - » formLogin; ?></div> 
</div> 


上 述 阴影 部 分 的 代码 就 是 用 来 显示 登录 表单 的 。 其 中 的 对 象 formLogin 是 在 
loginAction 中 通过 语句 : 
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$ this -> view- ^ formLogin- $ formLogin; 
传递 到 视图 中 的 表单 对 象 。 注 意 ,在 视图 中 this 后 面 没有 view, 因 为 这 时 的 this 表示 的 就 
是 视图 对 象 本 身 。 

在 浏览 器 中 输入 http://wmoams. com/user/login ,页 面 效 果 如 图 6.4 所 示 。 
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6.4 登录 表单 页 面 


从 图 6.4 可 以 看 出 ,登录 表单 对 象 正常 显示 ,但 布局 格式 不 尽 如 人 意 。 打 开 该 页 面 在 济 
览 器 中 的 源 文件 : 


<div class = "right"> 

«form id = "form login" enctype = "application/x - www - form - urlencoded" method = "post" 
action= ""» 

« dl class = "zend form"> 

« dt id = "username - label"»« label for = "username" class = "required"»Jf P! 4 : </label ></dt> 
« dd id = "username - element"> 

< input type = "text" name = "username" id= "username" value= "" /»«/dd» 

« dt id= "password - label"»« label for = "password" class = "required"> 密 码 : </label ></dt> 

< dd id = "password - element" 

< input type = "password" name = "password" id= "password" value= "" /></dd> 

«dt id= "提交 - label"» &# 160;«/dt »« dd id - "提交 - element" 

< input type = "submit" name = "提交 ”id= "提交 "value = "提交 ”/></dd> 

«/di» 

</form> 

</div> 


从 源 代码 中 可 以 看 出 ,Zend_Form A SÉ fe 9i rii P a h HEH T <d>, <dd>, <dt> 
标签 ,并 且 使 用 了 样式 类 zend_form, required 等 对 布局 进行 控制 ,因此 可 以 通过 对 这 些 标签 
或 样式 类 进行 重新 定义 来 满足 自己 的 特定 布局 要 求 。 

例如 ,在 login. phtml 中 添加 如 下 样式 代码 : 


< style type = "text/css"> 
dd(float:left;display:inline;height:30px; margin:15px} 
dt(float:left;display:inline;height:30px;margin:15px] 
# password - element(margin- left:25px] 
.zend form(width:300px; height :200px] 

</style> 


刷新 浏览 器 中 的 登录 界面 ,效果 如 图 6. 5 所 示 。 
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图 6.5 修改 登录 页 面 样式 后 的 效果 


图 6.5 所 示 的 效果 图 清楚 地 说 明 ,通过 重 写 样式 文件 可 以 有 效 地 控制 表单 的 布局 方式 。 
这 种 设置 页 面 布 局 的 方式 在 实际 应 用 中 不 太 方便 , 当 有 多 个 表单 对 象 存在 时 尤其 混乱 。 

Zend Framework 框架 提供 了 一 种 叫 * 表 单 装饰 器 ”的 布局 管理 方法 ,能 够 非常 灵活 地 
对 Zend Form 表单 进行 布局 设置 。 对 于 “表单 装饰 器 "将 在 本 章 的 6. 3 节 进 行 介绍 。 

4. 表单 的 处 理 

在 表单 创建 完毕 并 正常 显示 后 , 接 下 来 就 是 对 表单 数据 的 处 理 。 用 户 在 登录 表单 中 输 
和 人 “用户 名 ”“ 密 码 ” 后 ,数据 被 提交 到 User 控制 器 的 login 方法 中 。 数 据 的 处 理 包括 数据 
的 接收 有效 性 验证 ,注入 安全 防范 ,与 数据 库 中 的 注册 用 户 比 对 、 记 录 登 录 时 间 等 一 系列 操 
作 。 这 里 只 介绍 表单 的 简单 处 理 过 程 ,假设 用 户 名 密码 分 别 为 wmstudio 和 “123456” 的 用 
户 为 合法 用 户 。 

在 User 控制 器 的 login 方法 中 添加 如 下 代码 : 


class UserController extends Zend_Controller_Rction 


{ 


public function loginAction() 
( 


$ formLogin = new wm Form Login(); 
if( $ this -> getRequest() -> isPost())( 
if( $ formLogin -> isValid( $ POST))( 
$ data= $ formLogin - » getValues(); 
if( $ data[ 'username'] == "wnstudio" 
&& $ data[ 'password'] == "123456") 
$ this -> redirect( '/index/main'); 
else 
$ this -> view -> message = "用 户 名 或 密码 错误 !"; 
) 
) 
$ this -» view 一 > formLogin- $ formLogin; 


) 

在 上 述 代 码 中 ,首先 判断 请 求 是 否 来 自 于 表单 的 提交 , 即 是 否 为 用 户 单 击 表单 中 的 “ 提 
交 ” 按 钮 后 的 请 求 ; 若是 , 则 进入 登录 处 理 程序 。 在 登录 处 理 模 块 中 ,先进 行 表单 数据 的 有 
效 性 验证 ,这 些 有 效 性 规则 是 在 表单 类 的 定义 中 设置 的 ,例如 前 面 设置 的 “用 户 名 要 求 英 文 
5-20 个 字母 或 2-6 个 汉字 ”“ 密 码 要 求 至 少 6 个 字符 ”等 。 如 果 用 户 输入 的 数据 符合 设 定 的 
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规则 , 便 开始 用 户 名 与 密码 的 验证 。 这 里 只 进行 简单 的 登录 流程 验证 ,更 多 细节 将 在 6.5 节 
进行 介绍 。 

在 浏览 器 中 输入 http://wmoams. com/user/login, 打 开 用 户 登 录 页 面 。 在 表单 中 输入 
不 同 的 数据 ,页 面 效 果 如 图 6.6 和 图 6.7 Bron. 
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图 6.7 非法 用 户 登 录 页 面 效果 


从 图 6.6 可 知 ,用 户 输入 字符 的 长 度 少 于 设 定 的 长 度 时 ,验证 器 工作 正常 ,正确 给 出 了 
错误 提示 信息 。 图 6.7 所 示 为 用 户 输入 的 用 户 名 或 密码 与 注册 用 户 比 对 不 符合 ,控制 器 也 
正确 地 给 出 了 错误 信息 。 

注意 : 此 时 错误 信息 的 显示 是 以 列表 的 形式 分 别 显示 在 各 表单 元 素 下 面 的 。 


6.2 Zend_Form 表单 


上 面 通过 实例 操作 了 解 了 Zend Form 表单 的 创建 ,简单 修饰 与 处 理 的 基本 过 程 。Zend 
_Form 表单 在 Web 应 用 中 能 简化 表单 的 处 理 ,尤其 是 能 提供 元 素数 据 的 过 滤 与 校 验 。 它 充 
分 利用 Zend Framework 的 其 他 组 件 (例如 Zend_Config, Zend_Validate, Zend_Filter, Zend 
_Loader_PluginLoader 以 及 Zend_View 等 ) 协 同 实 现 其 强大 的 功能 。 


6.2.1 Zend Form 表单 元 素 


1. 表单 元 素 类 型 
Zend Framework 的 具体 表单 元 素 类 涵盖 了 大 部 分 的 HTML 表单 元 素 ,常用 的 类 型 及 


对 应 的 类 见 表 6. 1 。 
表 6.1 Zend_Form 表单 元 素 及 类 


类 型 类 
button Zend Form Element Button 
checkbox Zend Form Element Checkbox 
hidden Zend Form Element Hidden 
image Zend Form Element Image 
password Zend Form Element Password 
radio Zend Form Element Radio 
reset Zend Form Element Reset 
select Zend Form Element Select 
submit Zend Form Element Submit 
text Zend Form Element Text 
textarea Zend Form Element Textarea 


2. 表单 元 素 的 创建 

1) 使 用 Zend_Form 对 象 的 createElement 方法 

在 6.1 节 登录 表单 元 素 的 创建 过 程 中 ,我 们 使 用 的 就 是 这 种 方法 。 使 用 该 方法 创建 表 
单元 素 分 为 3 个 步骤 : 首先 创建 表单 元 素 对 象 ; 然后 为 元 素 对 象 属性 赋值 或 添加 校 验 器 ; 
最 后 将 表单 元 素 添加 到 表单 对 象 中 。 

createElement 方法 属于 Zend_Form 类 ,其 原型 如 下 : 


public function createElement( $ type, $ name, $ options = null); 


从 函数 的 形 参 列表 可 以 看 出 ,调用 该 函数 需要 带 两 个 或 3 个 参数 。 第 1 个 参数 type X 
示 表 单元 素 的 类 型 , 即 表 6. 1 中 的 类 型 名 称 , 如 登录 表单 中 的 用 户 名 文本 输入 框 和 密码 输入 
框 的 类 型 分 别 为 text 和 password: 第 2 个 参数 是 元 素 对 象 的 name 属性 值 ,这 是 表单 数据 
传递 时 的 变量 名 称 , 如 前 面 登 录 框 中 的 username 与 password: 第 3 个 参数 是 一 个 默认 参 
数 ,前 面 采用 的 是 它 的 默认 形式 。 通 过 这 个 参数 可 以 直接 定义 表单 元 素 的 样式 ,例如 登录 框 
中 “用 户 名 ”文本 输入 框 的 创建 ,也 可 以 写成 如 下 形式 : 
$ userName = $ this - > createElement('text', 'username', array( 
abel'= >' 用 户 名 : ', 
'required' => true, 
'validator' = > array( 'stringLength',false,array(5,20)), 
'erroMessage' =>' 用 户 名 要 求 英文 5 - 20 个 字母 或 2-6 个 汉字 ' 
)) 
代码 中 的 required 表示 该 表单 元 素 是 必要 的 ,stringLength 是 一 个 字符 长 度 校 验 器 。 
当然 ,还 可 以 添加 其 他 类 型 的 核验 器 及 过 滤器 。 
2) 使 用 表单 元 素 对 象 创建 
用 户 可 以 不 使 用 Zend. Form 对 象 的 createElement 方法 ,直接 用 new 创建 所 需 的 表单 
元 素 对 象 ,并 对 表单 对 象 属性 赋值 或 配置 校 验 器 与 过 滤器 ,然后 用 Zend Form 对 象 的 
addElement 方法 将 表单 元 素 添 加 到 表单 对 象 中 。 代 码 如 下 : 
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$ this — > addElement(new Zend Form Element Text('username', 
array( ”'label'=>' 用 户 名 : '， 
'required' => true, 
'validator' = > array( 'stringLength', false, array(5, 20) ), 
'erroMessage' =>' 用 户 名 要 求 英 文 5 - 20 个 字母 或 2- 6 DUE 
) )) 7 


6.2.2 Zend Form 表单 属性 设置 


在 HTML 中 ,表单 具有 多 个 属性 ,例如 name,id;method,action 等 。Zend_Form 表单 
在 创建 时 也 要 对 这 些 属 性 进行 设置 。 

在 Zend Framework 库 中 找到 文件 Form. php, 打 开 Zend, Form 类 的 源 文件 ; 或 在 
Zend Studio 集成 开发 环境 中 用 鼠标 指向 代码 中 的 Zend. Form 类 名 , 单 击 智能 指示 框 中 的 
显示 源 文件 图 标 ,快速 打开 Zend. Form 类 的 源 文件 ,如 图 6.8 所 示 。 


1 <?php 
2 

3^class Wm Form Login extends Zend Form 
af 


public function init() 


/ /表单 属性 
9 $this->setName(' forf 
10 -»setMethod('p 
11 / /用 户 名 输入 文本 框 
12 $userName = gthis-yi 
13 $userName-»setLabel| 
14 $userName-»setRequil|, — - 
15 guserName->addvalidj| 

16 $userName-»addErrorl! - 
17 $this-»addElement($6 
18 7/ 密码 输入 框 

19 $password = $this-»createElement('password', 'password'); 
20 $password-»setLabel('z8: '); 

21 $password-»setRequired(TRUE) ; 

22 $password-»addValidator('stringlength', false, array(6)); 
23 $password-»addErrorMessage( "密码 要 求 至 少 6 个 字符 ); 

24 $this-»addElement($password); 

25 7/ 提交 按钮 


tenhmit — tthic->rnaataFlomant/ 'cuhmit" 


nart). 


6.8 Zend Studio 集成 开发 环境 的 智能 提示 
Zend, Form 类 中 有 很 多 带 有 sec 前 级 的 方法 ,如 图 6. 9 所 示 ,使 用 这 些 方法 对 表单 属性 


在 前 面 用 户 登录 表单 的 创建 中 ,我 们 使 用 了 setName 方法 设置 表单 的 name 属性 值 为 
form_login; 使 用 setMethod 方法 设置 表单 的 method 属性 值 为 post。 除 此 之 外 ,还 可 以 使 
用 setAction、setAttrib、setAttribs 等 方法 设置 表单 的 id, action, style, class 等 属性 值 。 代 
码 如 下 : 

$ this -> setName( 'form login') 

一 > setMethod( 'post') 


-> sethction( '/user/register') 
一 > setAttrib('id', 'login form') 


一 > setAttrib('class', form login class') 
一 > setAttrib('style', margin:Opx; padding:Opx'); 


在 浏览 器 中 显示 的 上 述 表单 的 源 代码 如 下 : 


< form id= "login form" enctype = "application/x- www- form— urlencoded" 
method = "post" 
action- "/user/registry" 
class = "form login class" 
style = "margin:0px;padding:0px"> 


从 代码 可 以 看 出 ,在 表单 类 中 设置 的 表单 属性 得 到 了 浏览 器 的 正确 解析 。 


BE Outline 5i. £& MVC Outline] emp =n 
setAction($action) E 
setAttrib(Skey, $value) 

setAttribs(Sattribs) 

setConfig($config) 

setDecorators($decorators) 

setDefault($name, $value) 

setDefaultDisplayGroupClass($class) 

setDefaults(Sdefaults) 

setDefaultTranslator($translatorznull) 

setDescription($value) 

setDisableLoadDefaultDecorators($flag) 
setDisableTranslator($flag) 
setDisplayGroupDecorators($decorators) 
setDisplayGroups($groups) 

set£lementDecorators($decorators, $elements null, Sincludeztru 
setElementFilters(Sfilters) 

setElements($elements) 

setElementsBelongTo(Sarray) 

setEnctype(Svalue) 

setErrorMessages($messages) 

setErrors($messages) 

setisArray($flag) 

setLegend($value) 

setMethod($method) 

setName($name) 

setOptions(Soptions) z 
* a O 
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图 6.9 Zend_Form 类 方法 


6.2.3 Zend Form 表单 实例 


为 了 讲解 方便 ,上 面 的 登录 表单 只 用 到 了 text, password 和 submit 3 种 类 型 的 表单 元 
素 , 下 面 通过 用 户 注册 表单 的 创建 来 学 习 使 用 更 多 类 型 的 表单 元 素 。 

本 书 案例 是 一 个 办 公 自 动 化 管理 系统 ,这 种 应 用 一 般 是 不 设 用 户 注册 功能 的 ,用 户 的 注 
册 巾 管理 员 在 后 台 批量 注入 ,在 前 台 用 户 模块 中 只 设置 用 户 修改 或 完善 个 人 信息 的 相关 操 
作 。 这 里 创建 一 个 用 户 信息 表单 ,用 作 * 用 户 登 录 ” 及 “用 户 个 人 信息 修改 ?功能 实现 的 共用 
表单 。 

1. 用 户 信息 表单 的 创建 

用 户 信 息 根 据 应 用 项 目的 需求 进行 设置 ,主要 有 姓名 、 密 码 、 性 别 、. 年 龄 .民族 .邮箱 简介、 


第 
6 
工 号 .职称 .照片 用户 状态 ,用户 角色 等 。 为 了 简单 .这 里 选用 上 述 部 分 字段 ,创建 步骤 如 下 : * 
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CD 打开 Zend Studio 集成 开发 环境 ,选择 wmProject 项 目 。 
(2) 选择 Project| Zend Tool 菜单 项 ,打开 ZF Tool 工具 命令 窗口 ,输入 命令 : 


Zf create form User 
(3) 打开 applicationMormsVUser. php 文件 ,添加 代码 : 


class Wm Form User extends Zend Form 
{ 
public function init() 
{ 
// 表 单 属性 
$ this 一 > setName( 'form user') 
一 > setMethod( 'post') 
-> addAttribs(array( 
'style' => 'margin:5px; padding:5px' 
); 
// 用 户 登录 名 
$ netName = $ this -> createElement( 'text', netname'); 
$ netName 一 > setLabel( ' 登 录 名 : '); 
$ netName - > setRequired(TRUE); 
$ netName - > addValidator( 'stringLength',false,array(5,20)); 
$ netName - > addErrorMessage( ' 登 录 名 要 求 英文 5 - 20 个 字母 或 2-6 个 汉字 '); 
$ this - > addElement( $ netName) ; 
// 职 工 姓名 
$ userName = $ this -> createElement( text', 'username'); 
$ userName - > setLabel( ' 职 工 姓名 : '); 
$ userName - > setRequired(TRUE); 
$ userName - > addValidator( 'stringLength',false,array(5,20)); 
$ userName - > addErrorMessage( ' 要 求 英文 5 - 20 个 字母 或 2- 6 个 汉字 '); 
$ this - > addElement( $ userName) ; 
// 职 工 号 
$ userId= $ this -> createElement( 'text', 'userId'); 
$ userId - » setLabel(' 职 工 号 : '); 
$ userId- > setRequired(TRUE); 
$ userId- > addValidator( 'stringLength', false, array(6)); 
$ userId- > addErrorMessage( ' 职 工 号 要 求 至 少 6 个 字符 '); 
$ this - » addElement( $ userId); 
// 密 码 
$ password = $ this -> createElement( 'password', 'password') ; 
$ password -> setLabel( ' 密 码 : '); 
$ password - » setRequired(TRUE); 
$ password - > addValidator( 'stringLength',false,array(6)); 
$ password - > addErrorMessage( ' 密 码 要 求 至 少 6 个 字符 '); 
$ this - > addElement( $ password) ; 
// 确 认 密 码 
$ password2 = $ this -> createElement( password', 'password2'); 
$ password2 - > setLabel( ' 确 认 密码 : '); 
$ password2 — > setRequired(TRUE); 
$ password2 -> addValidator( 'identical',false,array( token' => 'password')); 
// 验 证 两 个 密码 是 否 相同 
$ password2 - > addErrorMessage( ' 两 次 输入 的 密码 密 要 相同 '); 
$ this - > addElement( $ password2); 
// 性 别 


$ sex= $ this -> createElement( 'radio', 'sex'); 
$ sex -> setLabel( ' 性 别 : '); 
$ sex - » addMultiOptions(array(17»'88 ',0 7 »'4p')); 
$ sex - » setSeparator(""); 
$ this - > addElement( $ sex); 
// 年 龄 
$ userAge- $ this -> createElement( text', 'userage'); 
$ userAge - » setLabel( ' 年 龄 : '); 
$ userAge - > setRequired(TRUE); 
$ userAge - » addValidator( NotEmpty',true); 
$ userAge - > addErrorMessage( ' 用 户 年 龄 不 能 为 空 '); 
$ this—>addElement( $ userAge); 
// 所 属 部 门 
$ department = $ this -> createElement( 'text', 'department'); 
$ department - > setLabel( ' 所 属 部 门 : '); 
$ department — > setRequired(TRUE) ; 
$ department - > addValidator( 'stringLength', false, array(5,20)); 
$ department - > addErrorMessage( ' 部 门 要 求 英文 5 - 20 ^E EX 2-6 XE. '); 
$ this 一 > addElement( $ department); 
// ABUSE [8] 
$ registdate- $ this -> createElement( text', 'registdate'); 
$ registdate 一 > setLabel(' 人 职 时 间 : '); 
$ registdate - > setRequired(TRUE); 
$ registdate - > addValidator( NotEmpty',true); 
$ registdate - > addErrorMessage( ' 用 户 人 职 时 间 不 能 为 空 '); 
$ this - > addElement( $ registdate); 
// 电 子 邮 件 
$ email = $ this -> createElenent('text', 'email'); 
$ email -> setLabel( ' 电 子 邮 箱 : '); 
$ email -> addValidator( 'EmailAddress'); 
$ email -> addErrorMessage( ' 请 输入 一 个 有 效 的 email 地 址 '); 
$ this - > addElement( $ email); 
// 个 人 简介 
$ profile- $ this -> createElement( 'textarea', 'profile'); 
$ profile-» setLabel( 4 A ffj4r : '); 
$ profile -> setAttribs(array('cols'-» 40, 'rows'=> 8)); 
$ this - » addElement( $ profile); 
// 照 片 
$ avatar = $ this -> createElement( 'image', 'avatar'); 
$ avatar -> setLabel('Wi p: '); 
$ avatar -> setAttrib('src', /images/pic0l.jpg'); 
$ this - > addElement( $ avatar); 
// 用 户 状态 
$ status = $ this - > createElenent( 'select', 'status'); 
$ status 一 > setLabel( ' 用 户 状 态 '); 
$ status - > addMultiOptions(array( 
了 1'=>' 激 活 '， 
'0'=>' 锁 定 '， 


)); 

$ this 一 > addElement( $ status); 

// 用 户 角 色 

$ role- $ this -> createElement( 'select', 'role'); 
$ role-> setLabel( ' 选 择 角色 : '); 

$ role- » addMultiOptions(array( 
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"user'=>' 普 通用 户 '， 
"editor' =>' 部 门 管理 员 '， 
'subadmin' =>' 部 门 负责 人 '， 
'admin' =>' 系 统管 理 员 ' 

); 

$ role -> setRequired(TRUE); 

$ this - > addElenent( $ role); 

// 提 交 按 钮 

$ submit = $ this - > createElement( 'submit', 'submit'); 

$ submit -> setLabel( ' 登 录 '); 

$ this - > addElement( $ submit); 


} 


2. 用 户 信息 表单 的 显示 

用 户 信息 表单 作为 登录 、 注 册 与 用 户 信息 修改 的 通用 表单 ,在 不 同 的 使 用 环境 中 显示 的 
内 容 是 不 同 的 。 例 如 作为 用户 登录 ?表单 使 用 时 , 仅 使 用 "登录 名 ”“ 密 码 ”"“ 确 认 密 码 ”、 
“提交 ”4 个 表单 元 素 ; 用 作 “ 用 户 个 人 信息 修改 ”表单 时 ,不 能 显示 “用 户 名 ”等 一 些 用 户 没 
有 权限 修改 的 表单 元 素 ; 而 在 用 作 系统 管理 员 的 “用 户 注册 信息 ”修改 表单 时 ,需要 显示 全 
部 的 表单 元 素 。 也 就 是 说 ,不 同 的 用 户 权 限 .不 同 的 使 用 场合 ,需要 显示 不 同 的 内 容 。 

1) 全 部 显示 

按照 前 面 介绍 的 方法 分 别 在 控制 器 .视图 中 添加 代码 。 

(1) 用 ZF Tool 工具 在 User 控制 器 中 创建 register 方法 ,并 添加 如 下 代码 : 


class UserController extends Zend Controller Action 


{ 


public function registerAction() 
{ 
$ formUser = new wn Form User(); 
$ this -> view 一 > formUser = $ formUser; 


) 


(2) 修改 视图 代码 。 打 开 User 控制 器 的 register 方法 对 应 的 视图 文件 application V 
views\scripts\user\register. phtml, 删 除 原 有 代码 ,添加 新 代码 : 

<br /><br /> 

<?php echo $ this 一 > formUser; ?> 

(3) 启动 Apache 服务 器 ,在 浏览 器 的 地 址 栏 中 输入 http://wmoams. com/ user/register， 
页 面 效 果 如 图 6. 10 所 示 。 

2) 登录 显示 

打开 User 控制 器 的 login 方法 ,修改 原 有 代码 .使 用 新 建 的 user 表单 蔡 换 原 有 的 login 
表单 ,并 移 除 user 表单 中 不 必要 的 表单 元 素 。 代 码 如 下 : 


public function loginAction() 


// 关 闭 默 认 布 局 模板 
$ this—> helper -> layout 一 > disableLayout(); 


// 使 用 User 表单 

$ formLogin = new wm Form User(); 

// 移 除 不 必要 的 表单 元 素 

$ formLogin— > removeElement( 'username'); 

$ formLogin —  removeElement( userId'); 

$ formLogin 一 > removeElement( 'userage'); 

$ formLogin 一 > removeElement( 'sex') ; 

$ formLogin — > removeElement( 'department ') ; 
$ formLogin - > removeElement( 'registdate'); 
$ formLogin 一 > removeElement( 'email'); 

$ formLogin - removeElement( 'avatar'); 

$ formLogin - > removeElement( 'status'); 

$ formLogin - > removeElement( 'profile'); 

$ formLogin— > removeElement( 'role'); 


if( $ this -> getRequest() -> isPost()){ 
if( $ formLogin-» isValid( $ _POST)){ 
$ data= $ fornLogin -> getValues(); 
if( $ data[ 'username'] == "wnstudio" && 
$ data[ 'password'] == "123456") 
$ this -> redirect( '/index/main'); 
else 
$ this -> view- > message = "用 户 名 或 密码 错误 !"; 
) 


} 
$ this -> view -> formLogin = $ formLogin; 
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图 6.10 用 户 信息 表单 页 面 
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使 用 user 表单 的 登录 页 面 效果 如 图 6. 11 所 示 。 


敏 梦 办 公 自动 化 管理 系统 


图 6.11 使 用 用 户 信息 表单 的 登录 页 面 


从 上 面 的 案例 可 以 看 出 ,使 用 Zend Form 表单 不 仅 能 够 增强 代码 的 重复 利用 ,提高 项 
目的 开发 效率 ,而 且 通过 它 添加 \ 删 减 系 统 功能 也 非常 方便 ,这 也 显示 出 了 采用 面向 对 象 的 
编程 方式 以 及 MVC 的 开发 模式 进行 项 目 开发 的 突出 优势 。 


6.3 Zend Form 表单 装饰 器 


在 前 面 6. 1. 2 节 登 录 表 单 的 显示 中 采用 了 重新 定义 过 dl 二 过 dd>、 志 dt 标签 样式 的 
方式 对 界面 进行 了 简单 的 布局 ,效果 显示 这 种 方法 是 可 行 的 。Zend Framework 提供 了 另 
一 种 比较 好 的 表单 布局 方法 ,通过 添加 表单 装饰 器 来 控制 表单 的 显示 布局 。 


6.3.1 Zend_Form 表单 装饰 器 的 类 型 


Zend_Form 表单 使 用 以 下 5 个 装饰 器 。 

(D. ViewHelper: 使 用 一 个 标准 表单 视图 帮助 器 来 呈现 表单 元 素 , 并 指定 一 个 视图 助 
手 用 于 解析 元 素 。 在 默认 情况 下 ,Zend_Form_Element 指定 formText 视图 助手 。 

(2) Errors: 通过 一 个 无 序列 表 呈 现 验证 错误 ,使 用 Zend_View_Helper_FormErrors 
追加 错误 消息 给 表单 元 素 , 如 果 没 有 错误 ,就 不 追加 。 

(3) Description; 呈现 附加 在 元 素 上 的 相关 描述 ,通常 用 于 提示 tooltips。 

(4) HtmlTag: 默认 用 一 个 二 dd 二 标签 包括 以 上 (1)、(2)、(3) 中 的 全 部 内 容 。 

(5) Label; 呈现 放置 在 以 上 内 容 之 前 的 标签 label, 默 认 用 一 个 二 dt 二 标签 包围 。 即 使 
用 Zend_View_Helper_FormLabel 预先 准备 一 个 标签 给 元 素 , 并 把 它 封 装 在 一 个 二 dt 二 标 
Ag, 

在 上 面 的 5 个 装饰 器 中 ,Description 用 于 信息 提示 ,用 得 非常 少 ,常用 的 是 另外 4 个 。 
这 些 装 饰 器 对 存储 在 表单 元 素 里 的 元 数据 的 片段 进行 操作 。 


6.3.2 Zend Form 表单 装饰 器 的 工作 原理 


一 般 情 况 下 ,在 表单 元 素 对 象 的 初始 化 过 程 中 加 载 默认 的 表单 元 素 装 饰 器 ,其 加 载 顺 序 
依据 各 个 装饰 器 的 注册 顺序 ,所 以 在 注册 Zend_Form 表单 装饰 器 时 一 定 要 注意 它们 的 添加 


顺序 。 当 然 , 也 可 以 通过 传递 disableLoadDefaultDecorators 属性 给 表单 元 素 对 象 的 构造 方 
法 来 关闭 它 , 例 如 : 

$ element = new Zend Form Element( 'foo', 

array( 'disableLoadDefaultDecorators'- > true)); 

对 于 Zend Form 表单 ,初始 内 容 由 ViewHelper 装饰 器 生成 , 它 生成 表单 元 素 自己 ; 接 
着 Errors 装饰 器 从 元 素 里 抓 取 错误 消息 ,如 果 有 任何 错误 ,就 传递 给 FormErrors 视图 助手 
来 解析 ; 下 一 个 装饰 器 HtmlTag 在 一 个 HTML 二 dd 二 标签 里 封装 元 素 和 错误 ; 最 后 ， 
Label 装饰 器 读 取 元 素 的 标签 并 传递 给 FormLabel 视图 助手 ,封装 在 一 个 HTML 二 dt 二 标 
签 里 。 即 Zend Form 表单 装饰 器 的 工作 分 成 以 下 4 个 步骤 ， 

(1) ViewHelper 分 离 出 每 个 元 素 并 呈现 它 ; 

(2) Errors 分 离 验 证 错误 并 用 一 个 无 序列 表 呈 现 它们 ; 

(3) HtmlTag 生成 一 个 HTML 标签 ,把 以 上 两 者 包 起 来 (默认 使 用 二 dd 二 标签 ); 

(4) Label 装饰 器 分 离 label 标签 并 呈现 它 ( 默 认 使 用 二 dt 二 标签 )。 

这 就 类 似 于 一 个 洋葱 ,从 里 到 外 按 顺 序 层 层 包 庄 ,所 以 我 们 可 以 形象 地 把 表单 装饰 的 过 
程 看 作 从 内 到 外 创建 洋葱 的 过 程 , 如 图 6. 12 所 示 。 

附加 内 容 ， 泻 染 带 ”呈现 表单 元 素 


有 label 标 签 的 元 素 — viewHelper 
Label decorator, decorator 


1 
clearDecorators 


用 表单 的 tag 及 其 泻 染 所 有 表单 元 素 
属性 包 庄 所 有 元 素 。 和 它们 的 label 标 签 
FormDecorator FormElements 
decorator decorator 


图 6.12 表单 装饰 器 原理 


6.3.3 Zend Form 表单 装饰 器 实例 


下 面 用 Zend_Form 表单 装饰 器 来 布局 6. 2 节 中 创建 的 user 表单 。 
打开 application\forms\User. php 表单 文件 ,在 Wm_Form_User 表单 类 的 init 初始 化 
方法 末尾 添加 如 下 代码 : 
public function init() 
{ 
// 提 交 按钮 
$ submit = $ this - > createElement( 'submit', 'submit', array( 'label' =>' 提 交 '，'ignore' = > 
true) ) 
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$ this - » addElement( $ submit); 
// 表 单 装饰 器 
$ this - 7» setElementDecorators(array( 
'ViewHelper', 
"Errors', 
array(array('data' = »'HtmlTag'),array( tag' =>'td')), 
array('label',array('tag' =>'td')), 
array(array( 'row' = >'HtmlTag'), array( 'tag' =>'tr')) 
)); 
$ this - » setDecorators(array( 
‘FormElements', array( 'Htnl'Tsg ', array( 'tag' 7» 'table', 'class' =>'usertable'), Forn') 
); 
) 


以 上 代码 依照 上 面 介绍 的 从 里 到 外 的 次 序 重新 设置 了 表单 装饰 器 , 先 用 Zend Form 类 
中 的 setElementDecorators ) 方 法 改写 表单 元 素 装 饰 器 ,ViewHelper 和 Errors 采用 默认 设 
E ,把 默认 的 HtmlTag 和 Lable 改 成 了 二 td 单元 格 标签 ,然后 多 加 一 行 代码 ,在 以 上 的 全 
部 代码 外 面 再 包 上 一 层 ,用 二 tr 二 (也 就 是 表格 中 的 “ 行 ”") 作 为 标签 把 它们 包 于 了 起 来 。 

接着 用 Zend_Form 类 中 的 setDecorators() 方 法 对 表单 进行 设置 ,在 表单 的 最 外 层 套 上 
了 二 table 志 标签 ,同时 还 给 它 设 定 了 CSS 的 class 类 样式 ,这 样 表 单 就 被 放 在 表格 中 了 ,从 
外 到 里 ,首先 是 二 table> ,再 往 里 是 二 tr> 行 ,每 行 里 又 有 两 个 二 td> ,分别 放 着 Label MK 
单元 素 , 这 就 是 大 家 非常 熟悉 的 表格 布局 方式 。 添 加 了 装饰 器 之 后 的 user 表单 页 面 效果 如 
图 6.13 所 示 。 
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图 6.13 用 户 信息 表单 装饰 器 页 面 效 果 


6.4 Zend Auth 认证 


在 6. 2 节 中 对 登录 表单 的 处 理 只 是 一 个 简单 的 验证 , 即 对 用 户 输入 的 数据 的 有 效 性 进 
行 了 检验 ,并 没有 对 用 户 身份 进行 认证 。 

用 户 登 录 其 实 就 是 一 个 寻求 认证 的 过 程 。 用 户 在 登录 表单 中 输入 一 些 必要 的 数据 , 程 
序 从 数据 库 中 查询 这 些 数 据 是 否 满足 认证 条 件 , 如 果 满 足 则 允许 登录 ,并 将 一 些 用 户 信息 注 
册 到 会 话 或 其 他 存储 对 象 中 ; 如 果 不 满足 , 则 拒绝 登录 。Zend Framework 提供 了 Zend_ 
Auth 组 件 实现 用 户 登录 认证 。 


6.4.1 Zend Auth 适配器 


1. Zend Auth 简介 

Zend Auth 组 件 是 Zend Framework 提供 的 用 户 访问 认证 组 件 , 称 为 访问 认证 适配器 。 
该 适配器 依靠 特定 的 认证 服务 (例如 LDAP, RDBMS 或 基于 文件 的 存储 ) 对 内 容 进行 认证 。 
基于 不 同 认证 服务 的 适配器 会 有 不 同 的 选项 和 行为 ,但 有 些 基 本 的 内 容 在 不 同 的 认证 适 配 
器 中 是 相同 的 。 例 如 ,接受 认证 证 书 、 依 靠 认证 服务 执行 查询 以 及 返回 结果 等 。 

每 个 Zend Auth 适配器 类 都 实现 了 Zend_Auth_Adapter_Interface 认证 基本 接口 。 该 
接口 定义 了 authenticate() 方 法 ,适配器 都 必须 实现 该 方法 。 在 调用 适配器 的 authenticate 方法 
之 前 ,每 个 适配器 还 必须 进行 初始 化 ,包括 设置 证 书 ( 如 用 户 名 和 密码 ) ,为 适配器 专用 的 配 
置 选项 定义 一 些 值 ( 如 为 数据 库 工 作 表 适 配器 做 的 连接 设置 ) 等 。 

2. 常用 认证 适配器 

常用 的 系统 认证 适配器 有 3 种 , 即 摘要 式 认 证 Zend. Auth. Adapter. Digest, % ji E iA 
证 Zend Auth Adapter DbTable 以 及 HTTP 认证 Zend_Auth_Adapter_Http。 

摘要 式 认 证 是 一 种 HTTP 认证 的 方法 ,该 方法 通过 不 需要 使 网 络 传递 明文 密码 的 
方法 对 基本 认证 加 以 改进 。Zend_Auth_Adapter_Digest 适配器 允许 依靠 文本 文件 进行 
认证 。 该 文本 文件 包括 数 行 摘要 式 认 证 的 基本 元 素 ,每 一 行 的 内 容 形 如 user: realm: 
ebbcoff9al21dbb6789bbe5f82174fa0。 其 中 ,user 为 用 户 名 ,realm 为 领域 ,最 后 为 密码 的 
MD5 值 。 

数据 库 认 证 是 最 重要 的 认证 方法 ,Zend_Auth 中 的 适配器 DbTable 用 于 提供 依靠 数据 
库 表 中 的 记录 内 容 进行 认证 的 功能 。 该 适配器 需要 Zend_Db_Adapter_Abstract 的 实例 ( 数 
据 库 适配器 ) 传 递 给 它 的 构造 方法 ,所 以 每 个 实例 要 和 特定 的 数据 库 连接 绑 定 。 

Zend Framework 的 Zend_Auth_Adapter_Http 类 支持 符合 RFC-2617 规范 的 基本 认 
证 和 数字 HTTP 认证 。 数 字 认 证 是 在 基本 认证 的 基础 上 改进 而 来 的 ,是 不 需要 在 网 络 上 传 
输 明文 密码 的 一 种 认证 方式 。 如 果 要 进行 HTTP 认证 ,还 需要 为 Zend Auth Adapter | 
Http 对 象 提供 Resolver, Resolver 的 作用 是 接收 用 户 名 和 领域 ,并 返回 证 书 值 。 基 本 认证 
通常 期 望 接收 用 户 密码 的 Base64 编码 版 本 。 数 字 认 证 期 望 接收 用 户 的 用 户 名 、 领 域 和 密码 
的 hash 值 。 
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6.4.2 Zend Auth 认证 的 实现 


在 Zend Framework 提供 的 3 种 常用 认证 方法 中 ,我 们 采用 数据 库 认 证 的 方式 来 实现 
系统 的 用 户 登 录 认证 。 

1. 创建 用 户 信息 数据 表 

根据 第 3 章 中 给 出 的 总 体 设 计 方 案 在 数据 库 中 创建 一 个 用 户 信息 表 。 

打开 phpMyAdmin 数据 库 管理 工具 ,在 db_wmoams 数据 库 中 新 建 名 为 tb_users 的 数 
据 表 , 其 字段 含义 见 表 6. 2, 字 段 属性 如 图 6. 14 所 示 o 


表 6.2 tb users 数据 表 字 段 说 明 


字 段 名 说 明 
id 自 增 变量 ,主键 ,用 户 在 系统 中 的 唯一 标识 
netame 用 户 登 录 名 
staffNo 职工 工 号 
username 职工 姓名 
password 登录 密码 
sex 职工 性 别 
age 职工 年 龄 
nation 民族 
birth 出 生年 月 
idcard 身份 证 号 码 
education 学 历 
degree 学 位 
department 所 属 部 门 
depart_id 部 门 编号 
post 职务 
entrytime 和 人 职 时 间 
phone 电话 
email 邮箱 
profile 个 人 简介 
avatar 照片 
role 用 户 角 色 
status 用 户 状态 
time reg 用 户 注 册 时 间 
time_last 用 户 最 后 登录 时 间 


创建 用 户 信息 数据 表 后 ,在 表 中 插入 一 些 数据 ,以 便于 后 续 的 测试 。 例 如 登录 名 
wmstudio ,密码 el0adc3949ba59abbe56e057f20f883e( 即 123456) 。 注 意 密码 为 MD5 加 密 
值 ,也 可 以 用 其 他 加 密 算法 。 

2. 实现 数据 库 认 证 

在 Zend Studio 集成 开发 环境 中 打开 application\controllers 目录 中 的 UserController. php 
文件 , 先 在 User 控制 器 的 login 方法 中 删除 如 下 代码 : 


if( $ formData[ netname'] == 'wnstudio' && 
$ fornData[ 'password'] == 123456") 
$ this -> redirect( '/index/main'); 
else 


$ message . = "用 户 名 或 密码 错误 !"; 
然后 在 该 位 置 添加 新 代码 : 


// 取 得 默认 的 数据 库 适 配器 
$ db = Zend Db Table: :getDefaultAdapter(); 
// 实 例 化 一 个 Zend_Auth 适配器 
$ authAdapter = new Zend_Auth Adapter DbTable( 
$ db, 'tb users', 'usernane', 'password') ; 

// 设 置 认证 登录 名 及 密码 
$ authAdapter - > setIdentity( $ formData[ 'netname']) ; 
$ authAdapter - > setCredential(md5( $ formData[ 'password'])); 
// 执 行 认 证 
$ authResult = $ authAdapter 一 > authenticate(); 
if( $ authResult -> isValid())( 

$ this -> redirect( '/index/main'); 
}else{ 

$ message . = "用 户 名 或 密码 错误 !"; 


} 
名 字 类 型 排序 规则 Et o m OW" S 
i UNSIGNED Af Æ — AUTO INCREMENT 
netname ^ varchar20) utf8 general ci 是 NULL 
staffNo  char(6) ^ utf8_general_ci Sx 
username  varcha(20) utf8 general ci mox 
password — char32) ^ utf8 general ci 是 NULL 
sex tinyint(1) 是 NULL 
age int(4) 是 NULL 
nation varchar(20) utf8 general ci 是 NULL 
birth varchar(100) utf8 general ci 是 NULL 
idcard bigint(18) 是 NULL 
education char(10) ^ utf8 general ci 是 NULL 
degree char10) ^ utf8 general ci 是 NULL 
department varchar(100) utf8 general ci 是 NULL 
departid int(10) UNSIGNED &&. NULL. 
post cha(20) ^ utf8 general ci 是 NULL 
entrytime datetime 是 NULL 
phone varchar(20) utf8 general ci 是 NUL 
email varchar(255) utf8 general ci 是 NULL 
profile text utf8 general ci 是 NULL 
avatar varchar(255) utf8 general ci 是 NULL 
role varchar(20) tf general ci 是 NULL 
status tinyint(1) 是 NULL 
tme reg — int(11) 是 NUL 
time last — int(11) 是 NULL 


图 6.14 用 户 信息 表 属 性 设置 
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从 上 述 代码 可 以 看 出 ,Zend_Auth 认证 分 为 下 面 5 个 步骤 。 

1) 获取 数据 库 适 配器 

在 6.4.1 节 中 讲 过 ,采用 数据 库 认 证 方法 时 必须 绑 定数 据 库 连 接 。 这 里 通过 Zend_Db_ 
Table 类 的 静态 方法 getDefaultAdapter 获取 配置 文件 中 的 默认 数据 库 适 配器 对 象 。 

2) 实例 化 认证 适配器 

实例 化 一 个 Zend_Auth_Adapter_DbTable 适配器 对 象 authAdapter, 在 实例 化 时 通 
过 配置 该 适配器 的 属性 进行 初始 设置 。 从 代码 中 可 以 看 出 此 适配器 有 4 个 属性 ,分 别 
是 数据 库 对 象 (zendDb)、 数 据 表 名 (tableName)、 身 份 列 (identlbColunm) 和 证 书 列 
(credentialColunm) 。 

。 zendDb: 指定 数据 库 适 配器 。 

* tableName: 包含 认证 证 书 的 数据 库 表 名 ,执行 数据 库 认 证 查询 需要 依靠 这 个 证 书 。 

e identityColumn: 数据 库 表 的 字段 名 称 , 用 来 表示 身份 。 身 份 列 必 须 包含 唯一 的 值 ， 

例如 用 户 名 或 者 email 地 址 等 。 
* credentialColunm; 数据 库 表 的 字段 名 称 , 用 来 表示 证 书 。 在 一 个 简单 的 身份 和 密 
码 认 证 方式 下 ,证 书 的 值 对 应 用 户 密码 。 

这 里 的 代码 给 出 的 上 述 4 个 参数 分 别 是 db.tb users, netname 和 password, 

3) 设置 认证 身份 与 证 书 

使 用 认证 适配器 authAdapter 对 象 的 setIdentity 方法 将 表单 提交 的 “用 户 登 录 名 ” 
数据 netname 设置 为 身份 ; 使 用 其 setCredential 方法 将 密码 设 为 证 书 , 并 用 MD5 算法 
加 密 。 

4) 执行 认证 

以 上 各 项 参数 设置 完成 后 ,通过 认证 适配器 authAdapter 对 象 的 authenticate 方法 执行 
认证 ,并 得 到 返回 的 认证 结果 。 

5) 判断 认证 结果 ,确定 路 由 路 径 

获得 认证 结果 以 后 ,通过 认证 结果 对 象 Zend_Auth_Auth_Result 的 isValid 方法 判断 
认证 是 否 成 功 ,然后 确定 页 面 的 跳 转 方向 。 

在 调试 过 程 中 ,如 果 认 证 不 成 功 , 可 以 通过 Zend_Auth_Auth_Result 类 的 getCode、 
getMessages 方法 获取 认证 结果 内 容 , 判 断 认 证 失败 的 原因 。 


6.5 登录 功能 的 完善 


通过 上 面 几 节 的 介绍 ,系统 登录 功能 已 经 基本 完成 ,但 还 存在 一 些 不 太 完美 的 细节 。 例 
如 , 当 登 录 信息 验证 没 通过 时 ,给 出 的 错误 提示 信息 与 表单 元 素 纠缠 在 一 起 ,破坏 了 表单 的 
整体 布局 ; 用 户 身份 认证 通过 后 ,还 需要 对 用 户 的 某 些 信息 进行 保存 ,以 方便 后 续 页 面 的 认 
证 等 。 下 面 来 完善 这 些 细节 。 
6.5.1 验证 信息 的 集中 显示 

如 图 6.2、 图 6. 3 所 展示 的 界面 那样 ,将 登录 错误 信息 在 一 个 信息 提示 框 中 集中 显示 。 


1. 修改 视图 文件 
在 Zend Studio 集成 开发 环境 中 打开 视图 文件 application\views\scripts\user\login. 
phtml, 添 加 如 下 代码 : 


<div id= "login center"> 
« div class = "left"»« img src = "/images/login center mark.gif" /></div> 
< div class = "center"»«/div» 
< div class = "right"»«?php echo $ this —» formLogin; ?»«/div» 
<?php if(trim( $ this -> message) != ''):?» 
<div style = "position:absolute;right:10px;width:250px; 
height :250px; background: # ff0"> 
< div style = "width:80 % ; height:75 * ; background: # fff; 
margin: 20px auto; padding:lOpx;border:lpx solid # cc0"> 
<?php echo $ this -> message; ?> 
</div> 
</div> 
<?php endif; ?> 
</div> 


上 述 代码 中 的 变量 message 是 从 User 控制 器 的 login 方法 中 传递 过 来 的 用 户 登 录 表 
单 验证 信息 。 

2. 修改 控制 器 代码 

在 Zend Studio 集成 开发 环境 中 打开 applicationNcontrollersVUser. php 控制 器 文件 , 修 
改 或 添加 User 控制 器 的 login 方法 中 的 代码 ,例如 : 

$ message = ' 

if( $ this - > getRequest() -> isPost ( ) ) { 


$ formData = $ this - > getRequest() - > getParams( ) ; 
if( $ formLogin -> isValid( $ formData) ){ 


}else{ 
$ formLogin— > populate( $ formData); 
$ arrayMessage = $ formLogin -> getMessages(); 
if (isset( $ arrayMessage[ 'netname'][ '0'])) ( 


$ message . = ' '. $arrayMessage[ 'netname'][ '0']. '< br />'; 
) 
if (isset( $ arrayMessage[ 'password'][ '0'])) ( 

$ message . = ' '. $arrayMessage[ 'password'][ '0']. '< br />'; 
) 
if (isset( $ arrayMessage[ 'password2'][ '0'])) ( 

$ message . = ' '. $ arrayMessage[ 'password2 '][ '0']. '< br />'; 
) 


) 
} 
$ this -> view — > formLogin = $ formLogin; 
$ this -> view- > message = $ message; 


6.5.2 认证 信息 的 保存 


在 第 4 章 的 4. 1. 5 节 中 已 经 初始 化 了 一 个 认证 对 象 , 这 里 只 需要 将 认证 信息 存 人 该 对 
象 即 可 。 
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在 Zend Studio 集成 开发 环境 中 打开 User 控制 器 的 login 方法 ,添加 如 下 代码 : 


if( $ authResult -> isValid())( 
// 获 取 Zend Auth 认证 对 象 
$ auth - Zend Registry: :get( 'auth') ; 
// 保 存 认证 结果 信息 
$ auth- > getStorage() -> write( 
$ authAdapter 一 > getResultRowObject( 
array('id', 'usernane', 'department', 'role') 
)); 
$ this -> redirect( '/index/main'); 
}else{ 
$ message . = "用 户 名 或 密码 错误 !"; 
) 


在 第 4 章 的 4. 1.5 节 中 设置 认证 对 象 时 ,将 该 对 象 以 auth 的 名 字 存 储 在 了 注册 表 对 象 
中 。 这 里 可 以 通过 Zend Registry 类 的 静态 方法 get 直接 取出 ,然后 通过 Zend Auth | 
Storage Session 类 的 write 方法 将 认证 的 用 户 信息 保存 。 这 样 ,在 系统 的 其 他 地 方 就 可 以 
随时 获取 到 登录 用 户 信息 了 。 


6.5.3 认证 信息 的 使 用 


上 面 详 细 介绍 了 用 户 登 录 及 认证 过 程 , 并 得 到 了 认证 信息 ,但 这 些 信 息 要 在 页 面 中 使 用 
才能 发 挥 它 的 拦截 作用 。 例 如 ,在 浏览 器 中 直接 输入 http://wmoams. com/index/main. [ri] 
样 能 访问 到 系统 主页 ,请 求 绕 过 了 登录 页 面 ,很 明显 这 是 不 允许 的 。 

本 系统 为 办 公 系 统 ,用 户 必须 通过 认证 后 才能 进入 系统 页 面 ,所 以 ,系统 中 的 每 一 个 页 
面 都 必须 验证 用 户 是 否 登 录 。 通 过 前 面 的 学 习 , 我 们 已 经 非常 清楚 Zend Framework Jii A 
的 路 由 规则 ,访问 系统 中 的 任何 页 面 都 必须 通过 相应 的 控制 器 ,因此 ,可 以 在 每 个 控制 器 中 
完成 用 户 是 否 登录 的 判断 。 下 面 解决 绕 过 登录 页 面 直接 访问 系统 主页 的 问题 。 

在 Zend Studio 集成 开发 环境 中 打开 Index 控制 器 文件 application\controllers 下 的 
IndexController. php;, 添 加 如 下 代码 : 


class IndexController extends Zend Controller Action 
{ 
protected $ _user = null; 
public function init() 
{ 
$ auth= Zend_Registry: :get('auth'); 
if( $ auth-> hasIdentity()){ 
$ this->_user = $ auth; 
) 
) 


public function mainAction() 
t 


if( $ this-» user)( 
$ this -> render(); 


}else { 
$ this -> redirect('/'); 
exit(); 

) 


} 


为 了 方便 , 先 定义 了 一 个 控制 器 变量 _user, 并 在 init 方法 中 用 存储 在 注册 表 对 象 中 的 
认证 对 象 对 它 进 行 初始 化 。 接 着 ,在 main 方法 中 通过 _user 变量 的 值 进行 页 面 跳 转 , 若 用 
户 经 过 了 认证 ,继续 访问 main 方法 对 应 的 视图 页 面 ; 若 用 户 没 有 经 过 认证 , 则 跳 转 到 系统 
首页 ,这 里 也 可 以 让 页 面 跳 转 到 登录 页 面 , 即 在 redirect 方法 中 设置 访问 地 址 /user/login。 

通过 上 述 修改 后 ,在 浏览 器 中 输入 http://wmoams. com/index/main ,页面 跳 转 至 系统 
封面 首页 , 即 有 效 地 制止 了 用 户 的 非法 访问 。 


6.5.4 账户 注销 


用 户 登 录 后 还 需要 能 够 随时 注销 ,实现 用 户 注 销 非 常 简单 ,只 需 在 User 控制 器 添加 一 
个 方法 ,销毁 登录 时 创建 的 认证 信息 就 可 以 了 。 

启动 Zend Studio 集成 开发 环境 ,选择 项 目 工 作 区 的 wmProject 项 目 中 的 某 个 文件 或 
文件 夹 ,打开 Zend Tool 工具 命令 窗口 ,输入 命令 : 


zf create action logout User 
在 User 控制 器 中 创建 logout 方法 ,并 添加 代码 : 


public function logoutAction() 
{ 
$ auth = Zend Registry: :get('auth'); 
$ auth- > clearIdentity(); 
$ this -> redirect('/'); 
} 


上 述 阴 影 代码 中 的 第 1 句 获取 Zend_Auth 认证 对 象 ,第 2 句 清除 该 对 象 中 的 认证 信 
息 , 第 3 句 使 页 面 跳 转 到 系统 首页 。 

账户 注销 应 该 在 系统 中 的 任何 页 面 都 能 进行 ,页 面 中 的 “注销 ”链接 应 放 在 系统 的 布局 
模板 中 。 打 开 application\layouts\header. phtml 文件 ,添加 代码 : 


<div id = "header"> 
<div id= "logo" 
< img src = "/images/logo. jpg"> 
< div id = "usepanel"> 
<a href = '/user/1logout'> 注 销 </a> 
</div> 
</div> 
</div> 
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6.6 本 章 小 结 


本 章 通过 系统 登录 系列 功能 的 实现 详细 介绍 了 Zend Framework 的 表单 组 件 Zend_ 
Form 以 及 认证 组 件 Zend_Auth, 主 要 内 容 包括 表单 的 创建 、 验 证 器 及 样式 的 设置 .表单 的 
装饰 ,表单 的 显示 与 数据 处 理 , 以 及 用 户 登录 认证 的 数据 库 认 证 方法 。 

表单 操作 是 Web 应 用 开发 中 最 重要 也 是 最 常用 的 功能 ,是 本 章 的 学 习 重 点 。Zend 
Framework 的 Zend. Form 组 件 利 用 面向 对 象 的 封装 技术 将 以 往 凌 乱 的 HTML 代码 和 与 
之 相应 的 验证 ,处 理 等 复杂 操作 提升 到 了 一 个 新 的 层次 ,使 之 变 得 十 分 简单 ,也 更 容易 理解 。 


第 7 章 | 用 户 管理 及 Zend Framework 模块 


用 户 作为 应 用 系统 的 使 用 者 与 维护 者 ,是 系统 的 主要 服务 对 象 ,也 是 系统 生存 与 发 展 的 
重要 因素 。 办 公 自 动 化 管理 系统 中 的 用 户 信 息 管理 一 般 分 为 前 台 管 理 与 后 台 管理 两 个 部 
分 。 前 台 管 理 主要 是 用 户 对 自身 信息 的 维护 ,而 后 台 管理 , 则 是 系统 管理 员 对 系统 所 有 用 户 
的 信息 的 管理 ,包括 用 户 的 注册 、 删 除 、 更 改 以 及 各 种 各 样 的 查询 等 。 

本 章 通过 实现 案例 项 目的 用 户 信息 管理 功能 ,介绍 Zend Framework 的 模块 以 及 职工 
信息 的 增 、 删 \ 改 、 查 等 数据 库 操作 。 


7.1 系统 后 台 管 理 模块 


在 第 2 章 中 介绍 Zend Framework 项 目 结 构 的 时 候 , 我 们 曾经 提 到 在 Zend Framework 
项 目的 目录 结构 中 可 能 会 有 一 个 名 为 modules 的 文件 夹 ( 见 表 2. 10 ,这 里 存放 的 文件 , 即 系 
统 的 模块 文件 。 


7.1.1 Zend Framework 模块 概述 


应 用 系统 中 的 “模块 "一般 指 “功能 模块 "。 对 于 Zend Framework 来 说 ,一 个 模块 一 般 
是 一 个 大 的 功能 区 , 几 个 模块 按照 一 定 的 规则 相互 联系 构成 更 加 复杂 的 系统 或 过 程 。 在 开 
发 过 程 中 ,通过 制定 规则 和 约定 将 系统 划分 成 模块 安排 分 工 , 可 以 极 大 地 提高 开发 效率 。 

模块 是 一 个 相对 的 概念 ,对 其 划分 没有 一 个 固定 的 规则 ,要 结合 应 用 系统 的 规模 、 精 细 
化 程度 、 开 发 人 数 和 分 工 、 开 发 路 线 图 等 因素 来 考虑 。 需 要 注意 的 是 ,模块 并 不 是 划分 得 越 
细 越 好 ,应 该 以 满足 需求 .方便 开发 人 员 相 互 协作 等 作为 划分 标准 。 模 块 划分 得 太 细 ,不 仅 
会 产生 运行 效率 问题 ,而 且 会 给 开发 工作 带 来 困扰 ; 如 果 划 分 得 太 粗 ,又 会 导致 应 用 程序 功 
能 局 部 腾 肿 ,耦合 度 增高 ,使 后 期 维护 成 本 增加 ,甚至 直接 影响 应 用 程序 的 生命 周期 。 

应 用 系统 中 的 不 同 模块 之 间 应 保持 尽量 低 的 耦合 度 ,在 需要 的 时 候 , 各 个 模块 之 间 应 尽 
可 能 地 相对 独立 ,这样 ,一 个 模块 出 现 问题 ,不 会 大 面积 影响 其 他 模块 。 这 里 讲 的 模块 “ 独 
立 ” 是 针对 代码 的 组 织 层面 而 言 的 ,在 内 在 逻辑 层 , 各 个 模块 是 不 能 完全 独立 的 ,所 以 对 模块 
低 耦 合 度 的 追求 也 要 与 应 用 程序 的 特点 和 规模 .代码 的 重用 等 结合 起 来 考虑 ,不 宜 过 度 。 


7.1.2 模块 的 创建 


应 用 系统 一 般 分 为 前 台 与 后 台 ,前 面 几 章 我 们 所 做 的 开发 均 属于 前 台 模 块 。 这 里 使 用 
了 "模块 > 这 个 词 , 也 就 是 说 前 面 编写 的 所 有 程序 实际 上 也 是 一 个 模块 , 它 就 是 默认 模块 
default。 大 家 可 以 在 浏览 器 的 地 址 栏 中 输入 http://wmoams. com/default/user/login 来 
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访问 系统 的 登录 页 面 , 请 求 是 有 效 的 。 这 说 明 default 模块 是 存在 的 ,只 是 因为 它 是 默认 模 
块 ,就 像 默 认 控 制 器 Index、 默 认 方 法 index 一 样 , 可 以 在 访问 路 径 中 予以 省 略 。 

下 面 使 用 ZF Tool 工具 创建 一 个 后 台 管理 模块 。 启 动 Zend Studio 集成 开发 环境 ,定位 
到 案例 项 目 wmProject 中 ,打开 ZF Tool 工具 ,在 命令 窗口 中 输入 : 


zf create module admin 


即 在 项 目 中 创建 了 一 个 名 为 admin 的 模块 ,注意 模块 名 大 小 写 敏感 。 

命令 执行 完毕 后 ,展开 项 目的 application 目录 ,可 以 看 到 在 该 目录 下 新 创建 了 一 个 名 
为 modules 的 目录 ,里 面 又 有 一 个 admin 文件 夹 ,其 中 包括 controllers, models, views 3 个 
空 目录 ,将 分 别 用 来 存放 该 模块 的 控制 器 、 模 型 和 视图 文件 。 很 明显 ,新 模块 admin 也 将 采 
用 MVC 的 模式 来 组 织 。 

另外 ,ZF Tool 工具 还 在 application. ini 配置 文件 中 添加 了 一 行 配置 代码 来 指定 模块 的 
访问 路 径 : 

resources. frontController.moduleDirectory = APPLICATION PATH "/modules" 

在 前 面 的 程序 开发 过 程 中 ,我 们 使 用 的 名 字 空 间 为 Wm_, 它 是 作用 于 默认 模块 default 
上 的 。 在 新 的 模块 中 ,应 用 程序 将 启用 模块 名 作为 名 字 空 间 。 也 就 是 说 ,在 Admin 模块 中 


创建 控制 器 .添加 模型 时 都 将 以 Admin_ 作 为 前 级 。 为 了 能 让 应 用 自动 搜索 到 这 些 资源 , 需 
要 在 application. ini 文件 中 增加 如 下 配置 : 


resouces. modules[] = "" 


这 样 确保 了 模块 作为 资源 被 自动 注册 到 配置 文件 中 ,模块 也 就 能 正常 工作 了 。 
7.1.3 控制 器 的 创建 与 初始 化 


1. 创建 控制 器 

在 模块 中 创建 资源 的 方法 与 前 面相 同 , 只 是 在 命令 中 要 加 入 模块 名 ,用 来 指明 该 资源 属 
于 哪个 模块 。 

打开 Zend Studio 集成 开发 环境 中 的 Zend Tool 工具 命令 窗口 ,分 别 输入 命令 : 

Zf create controller Index 1 admin 
和 

Zf create controller User 1 admin 
在 模块 admin rl 8]££ Index, User 控制 器 ,命令 行 中 的 “1” 表示 在 创建 控制 器 的 同时 添加 
index 方法 及 视图 。 注 意 命令 中 必须 加 入 admin 模块 名 ,否则 控制 器 创建 到 默认 模块 (也 就 
是 default 模块 ) 中 ,就 像 我 们 以 前 做 的 一 样 。 

打开 新 创建 的 控制 器 代码 , 它 的 类 名 与 默认 模块 中 的 控制 器 类 有 所 不 同 。 在 admin 
模块 中 创建 的 控制 器 类 名 均 以 Admin_ 作 为 前 缀 ,即将 模块 名 首 字 母 大 写 后 作为 前 级 。 
例如 : 


class Admin IndexController extends Zend Controller Action 


public function init() 
{ 
/ * Initialize action controller here * / 
} 
public function indexAction() 
{ 
//action body 
} 
j 


2. 初始 化 控制 器 
在 User 控制 器 中 添加 一 些 变量 ,并 在 初始 化 方法 中 给 其 赋值 。 这 些 变量 是 在 以 后 的 
方法 中 需要 用 到 的 共性 参数 ,在 这 里 统一 进行 初始 化 ,例如 : 


class Admin UserController extends Zend Controller Action 
{ 
// 登 录用 户 
private $ user- null; 
// 是 否 登 录 标 志 
private $ login- null; 
// 职 工 信 息 
private $ employee = null; 
// 注 册 表 对 象 
private $ config- null; 
public function init() 
( 
$ this-» helper -> layout() - > setLayout( 'adnin'); 
// 初 始 用 户 表 模 型 
$ this 一 >_employee = new Wm Model User(); 
$ this- » config = Zend Registry: :get('config'); 
$ auth = Zend Registry::get('auth'); 
if( $ auth- > hasIdentity())( 
$this-» user- $ auth; 
$this-» login- true; 


7.1.4 后 台 管 理 模板 设计 


系统 的 后 台 管 理 模块 主要 用 于 系统 对 象 的 管理 与 系统 运行 的 维护 。 由 于 使 用 功能 上 的 
差异 , 它 的 页 面 布局 与 前 面 我 们 设计 的 前 台 模 板 应 该 是 不 一 样 的 ,所 以 有 必要 为 新 模块 启用 
新 的 布局 模板 。 

根据 第 3 章 中 设计 的 系统 总 体 结构 ,我 们 启用 如 图 7. 1 所 示 的 页 面 布局 模式 。 

1. 模板 页 面 设计 

在 目录 applicationMayoutsVscripts 下 新 建 admin. phtml 模板 文件 ,添加 如 下 代码 : 


<?php echo $ this -> docTYpe();?> 
<html> 
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< head» 


<?php echo $ this -> headTitle();?» 
</head> 
< body> 
<div id= "wrap"> 
<?php echo $ this -> partial( 'adminHeader. phtml');?» 
<div id = "breadnav" style = "width: 500px; ">< span> 您 目前 的 位 置 : 
<?php echo $ this -> position?></span></div> 

<div id = "nav"></div> 
<div id= "main" style = "width:100 * ;background: # ffffff"> 

<div id= "sidebar" 

<?php echo $ this - > partial('adminMenu. phtml');?></div > 
<div id= "content" style = "width:78 % "> 
<?php echo $ this -> layout() - > content ;?> 
</div> 


< div class = "clear"></div> 
</div> 
<?php echo $ this -> partial('adminFooter. phtml');?» 
</div> 
</body> 
</html> 
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图 7.1 用 户 信息 页 面 模板 效果 图 


该 模板 文件 是 在 前 台 模 板 layout. phtml 基础 上 修改 而 来 的 ,代码 中 省 略 的 部 分 与 原 模 
板 相同 。 

2. 启用 新 模板 

在 admin 模块 的 Index、User 控制 器 的 init 初始 化 方法 中 添加 如 下 代码 ,启用 新 的 
admin. phtml 模板 。 


$ this-» helper -> layout() - > setLayout( 'adnin'); 


启动 Apache 服务 器 ,在 浏览 器 的 地 址 栏 中 输入 http://wmoams. com/admin. Bl nT Æ 
到 新 模板 的 页 面 效果 。 
3. 验证 用 户 身份 
用 户 必须 登录 后 才能 进入 系统 。 由 于 采用 的 是 统一 登录 界面 ,所 以 如 果 是 具有 管理 员 
身份 的 用 户 登录 ,还 需要 在 系统 前 台 主 页 中 添加 链接 ,让 用 户 能 够 进入 系统 后 台 管 理 中 心 。 
另外 ,在 后 台 管 理 模块 的 每 一 个 页 面 中 还 要 添加 判断 用 户 是 否 登录 的 代码 ,如 果 用 户 不 是 从 
系统 首页 进入 , 则 强制 返回 系统 首页 。 
1) 添加 链接 
打开 layout 模板 文件 layou. phtml 中 的 head. phtml 视图 文件 ,在 系统 logo 标识 所 在 
的 div 标签 中 添加 “进入 管理 中 心 " 链 接 ,链接 地址 设置 为 /admin。 
2) 判断 用 户 是 否 登录 
在 admin 模块 的 Index 和 User 控制 器 中 分 别 添加 代码 : 
public function indexAction() 
í if(! $ this->_login){ 
$ this -> redirect('/'); 
exit(); 


) 


以 上 是 admin 模块 的 Index 控制 器 中 的 代码 ,User 控制 器 的 代码 与 其 相同 ,由 于 代码 
比较 简单 ,这 里 就 不 多 解释 了 。 系 统 的 访问 控制 , 即 用 户 的 权限 管理 ,将 在 第 12 章 详细 
介绍 。 


7.2 用户 信息 的 后 台 管 理 


用 户 信息 的 后 台 管理 包括 用 户 信息 的 查询 、 添 加 ,更改 ,删除 以 及 相关 的 信息 统计 与 报 
表 输 出 ,下 面 介绍 一 些 常 用 功能 的 实现 。 
7.2.1 查询 全 部 职工 信息 

用 户 信息 查询 包括 全 部 查询 与 分 类 查询 ,分 类 查询 根据 输入 的 条 件 对 查询 结果 进行 分 
类 。 本 节 实 现 所 有 职工 信息 的 查询 ,并 按 职工 入 职 时 间 对 查询 结果 进行 升降 序 排列 。 

1. 信息 显示 视图 

打开 Zend Studio 集成 开发 环境 ,在 ZF Tool 工具 窗口 中 输入 命令 : 

zf create action list User 1 admin 


在 admin 模块 的 User 控制 器 中 添加 list 方法 ,修改 application àmodulesVadmin views 
NscriptsNlist. phtml 视图 文件 : 
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<br/><br /> 
< style type = "text/css"> 


</style> 
< div class = "nav"> 
<ul> 
< li class = "lil"» «a href = " #" class = "a3"> 管 理 </a> </li> 
< li class = "li2"> <a href = " #" class = "a3"> 查 询 </a> </li> 
</ul> 
</div> 
« div class = "cell h"»«/div» 
"navi" ”<! 一 这 是 是 页 面 位 置 提示 --> </div> 
< div class = "cell h"»«/div» 
< div class = "looktype"» 
查看 方式 : <a href =" 井 " class = "al4"> 人 职 时 间 降 序 </a> 
«a href =" #" class = "al4"> 人 职 时 间 升 序 </a> 
</div> 
< div class = "cell h"»«/div» 
< table class = "table" align- "center" 


« div clas: 


«tr» 
<th style ="… "> 职工 姓名 </th> 
< th style ="…"> 所 属于 部 门 </th> 


<th style = "… "> 籍贯 </th> 
«th style = "…"> 人 职 时 间 </th> 
<th style = ".."-E- mail </th> 
<th style ="… "> 查看 </th> 
< th style = "… "> 编辑 </th> 
«th style ="… "> 删除 </th> 
</tr> 
<tr> 


<td style="#"> &nbsp; </td> 
<td style="#"> &nbsp; </td> 
<td style="#"> &nbsp; </td> 
<td style="#"> &nbsp; </td> 
<td style="#"> &nbsp; </td> 
<td style="#"> 
<a href = " # ">< ing src = "/images/list.gif" title=" 查 看" border = "0"/></a> 
</td> 
«td style="#"> 
«a href = " # ">< ing src = "/images/edit. gif" title = "编辑 " border = "0"/></a> 
</td> 
<td style=" # "> 
<a href = " # ">< img src = "/images/del. gif" title= "删除" border = "0"/></a> 
</td> 
</tr> 
</table> 
< div class = "cell_h"></div> 
<div class = "navl"> ”<! 一 这 里 是 页 面 导 航 --> </div> 


< div class = "cell h"»«/div» 


该 代码 中 省 略 了 CSS 样式 代码 ,请 大 家 查询 教材 源码 。 页 面 效果 如 图 7.2 所 示 。 
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2. 添加 方法 代码 
在 admin 模块 的 list 方法 中 编写 代码 : 


public function listAction () 


t 


} 


// 获 取 页 面 参 数 


所 属于 部 门 
计算 机 学院 
计算 机 学 院 
计算 机 学 院 
计算 机 学 院 
计算 机 学 院 
计算 机 学 院 
计算 机 学 院 
计算 机 学 院 


U 2*4 


5 [RA] 


入 了 时 间 
2014-07-29 00:00:00 
2000-04-07 00:00:00 
2000-04-06 00:00:00 
2000-04-05 00:00:00 
1996-10-09 00:00:00 
1996-10-09 00:00:00 
1996-10-08 00:00:00 
1996-10-08 00:00:00 


Email 
65135217484 com. 
65135217484 com 
65135217484 com. 
65135217484 com 
651352174 com. 
6513520744 com. 
651352174 com 
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6513521748 com. 


7.2 用 户 信息 显示 页 面 效 果 


$ page= $ this-» request - > getParam( page'); 
$1t- $ this->_request -> getParan( '1t'); 


// 每 页 显示 记录 数 
$ pageSize= 8; 
// 查 询 结果 分 页 


$ paginator = $ this - » user 一 > getByPage( $ lt, $ page, $ pageSize) ; 


// 传 递 页 面 参数 


$this-»view-»lt- $1t; 
$ this -> view — > paginator = $ paginator; 


// 设 置 页 面 信息 


$title- ' 职 工 信 息 列表 '; 


$ this ->_setPageInfo( $ title, $ title); 


3. 修改 User 模型 
打开 applicationVmodelsVuser. php 文件 ,添加 getByPage 方法 .代码 如 下 : 


public function getByPage ( $ orderIndex, $ page= 1, 
$ itemCountPerPage = 10, $ pageRange = 5) 


// 生 成 select X4 
$ select = $ this 一 > select(); 
$ select 一 > from( $ this- » name); 


// 排 序 方式 


if ($orderIndex==0) ( 
$ order = 'regtime desc'; 
} elseif ( $ orderIndex-- 1) ( 
$ order = 'regtime'; 
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) 
$ select — > order( 'usertype desc'); 
$ select -> order( $ order); 
//S ffl Zend Paginator 对 象 
$ paginatorAdapter = new Zend Paginator Adapter DbSelect( $ select); 
$ paginator = new Zend Paginator( $ paginatorAdapter); 
$ paginator - > setPageRange( $ pageRange) - > setItemCountPerPage( 
$ itemCountPerPage) - > setCurrentPageNumber( $ page) ; 
return $ paginator; 


} 
4. 添加 页 面 设置 函数 


private function setPageInfo ( $ title, $ position, $ layout = 'admin') 
{ 
// 当 前 页 面 位 置 
$ this -» view» position= $ this—> config[ 'pageInfo'][ 'default']['title'] 
.， >> 管理 中 心 >> '. $position; 
// 页 面 布 局 
if ( $ layout == null) { 
$ this-» helper- - layout - > disableLayout(); 
) eise ( 
$ this->_helper -> layout -> setLayout( $ layout); 


) 


5. 添加 分 页 控制 视图 
由 于 浏览 器 窗口 大 小 有 限 , 用 户 信 息 的 显示 需要 进行 分 页 处 理 。 在 applicationXmodulesN 
viewsNscripts 目录 下 添加 list user. pagination control. phtml 视图 文件 ,并 编写 代码 : 


< div style = "width: 280px; height:20px; line - height:20px; color: # 0257AE; font - weight: 
bold; text- align:center; border:lpx solid # 92C7ED; 
background - color: # FAFEFF; margin- right:8px; float:left;"» 
每 页 &nbsp;« font style = "color: # 999999; font- family:Arial; font - size:12px;"»«?php echo 
$ this - > itemCountPerPage?»«/font > &nbsp; /& /J& &nbsp;« font style = "color: # 999999; font - 
family:Arial; font- size:12px;"»«?php echo $ this -> totalltemCount?» «/font > gnbsp; 条 第 
&nbsp;« font style = "color: # 999999; font - family: Arial; font - size: 12px;"» «? php echo 
$ this - » current?» «/font > &nbsp; 页 / 共 &nbsp;« font style = "color: # 999999; font - family: 
Arial; font- size:12px;"»«?php echo $ this -> pageCount?» «/font > &nbsp; Ji 
</div> 
<?php if( $ this -> totalItemCount > 0) :?> 

<?php if( $ this -> current > 1) :?> 

< div style = "width: 40px; height:20px; line - height: 20px; border:1px solid # 92C7ED; 
background - color :<?php if( $ this - > current == 1) :?># 1A75D2;<? php else:?» # FAFEFF; «? php 
endif; ?> font - weight :bold; float:left; margin- right :8px; "> 

<a href = "<?php echo $ this - > baseUrl( '/admin/user/list/lt/'. $ this -> 1t. '/page/ 

1')?>" class = "<?php if( $ this -> current == 1) :?» a4 <?php else:?> a3 <?php endif;?>"> 首 页 </a> 

</div> 

<?php endif; ?> 

<?php foreach ( $ this - > pagesInRange as $ page) :?> 

< div style = "width: 20px; height:20px; line - height:20px; border:1px solid it 92C7ED; 


background - color:«?php if( $ this - > current == $ page):?» 4 1A75D2;«?php else:?» i FAFEFF; 
<?php endif;?» font - family:Arial; font- style: italic; font - weight:bold; float:left; margin — 
right:8px;"» 
<a href = "<?php echo $ this - > baseUrl( '/admin/user/list/lt/'. $ this - > lt. '/page/ 
'. $ page)?>" class = "<?php if( $ this - »current-- $ page):?» a4 <?php else:?» a3 <?php endif;? 
>"><?php echo $ page?» «/a» 
</div> 
<?php endforeach;?> 
<?php if( $ this - > pageCount > $ this - > pageRange && $ this - > pageCount!= $ this -> 
current) :?> 
< div style = "width: 40px; height:20px; line - height: 20px; border:1px solid # 92C7ED; 
background - color :<? php if ( $ this - > current == $ this - > last) :?> # 1A75D2;<? php else:?> 
# FAFEFF;«?php endif;?» font - weight :bold; float:left; margin- right :8px; "> 
<a href = "<?php echo $ this - > baseUrl( '/adnin/user/list/lt/'. $ this -> lt. '/page/ 
', $ this-> last)?>" class = "<?php if( $ this -> current == $ this -> last) :?> a4 <?php else:?> 
a3 <?php endif;?>"> 尾 页 </a> 
</div> 
<?php endif;?> 
<?php endif;?> 


6. 实现 所 有 职工 信息 查询 
图 7.2 所 示 的 是 用 户 信息 显示 空 模板 页 面 , 如 果 要 显示 查询 内 容 , 还 必须 在 模板 文件 中 


添加 内 容 , 代 码 如 下 : 


<br/><br /> 
< style type = "text/css"» 


</style> 
<div class = "nav"> 
<ul> 
< li class = "1il"> 
<a href = "/adnin/user/list/flag/all/1t/0/page/1" class = "a3"> 管 理 </a> 
</li> 
< li class = "li2"» <a href = " #" class = "a3"> 查 询 </a> </li> 
</ul> 
</div> 
< div class = "cell_h"></div > 
< div class = "nav1"> 
<?php echo $ this -> paginationControl( $ this -> paginator, 'Sliding', 
'list_user_pagination_control. phtml',array('lt'=> $ this -> lt))?> 
</div> 
<div class = "cell_h"></div > 
< div class = "looktype"> 
查看 方式 : <a href=" £" class = "al4"> 人 职 时 间 降 序 </a> 
«a href - " &" class = "al4"> 人 职 时 间 升 序 </a> 
</div> 
«div class = "cell h"»«/div» 
< table class = "table" align = "center" 
<tr> 
<th style ="…"> 职 工 姓名 </th> 
«th style ="…"> 所 属于 部 门 </th> 
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«th style ="… "> 籍贯 </th> 


< th style ="…"> 人 职 时 间 </th> 
<th style=".…">E- mail </th> 
«th style = "… "> 查看 </th> 
«th style = "…"> 编 辑 </th> 
«th style ="…"> 删 除 </th> 
</tr> 
<?php foreach ( $ this -> paginator as $ key=> $ user) :?> 


<tr> 

«td style = " # "><?php echo $ user[ 'usernane'] </td> 

<td style="#"> &nbsp; </td> 

<td style=" #"> &nbsp; </td> 

<td style="#"> &nbsp; </td> 

<td style="#"> &nbsp; </td> 

<td style=" #"> 
<a href = " # ">< img src = "/images/list. gif" title = "查看 " border = "0"/></a> 
</td> 

<td style=" #"> 
<a href = " # ">< img src = "/images/edit. gif" title = "编辑 " border = "0"/></a> 
</td> 

<td style= "#"> 
<a href = " # ">< img src = "/inages/del.gif" title - "删除 " border = "0"/></a> 
</td> 

</tr> 

<?php endforeach;?> 
</table> 


< div class = "cell_h"></div > 
« div class = "nav1"> 
<?php echo $ this -> paginationControl( $ this -> paginator, 'Sliding', 
"list user pagination control.phtnl',array('lt'- 7$ this- » 1t))?» 
</div> 
<div class = "cell_h"></div> 


为 了 让 管理 员 打 开 User 控制 器 首页 就 能 看 到 职工 的 全 部 信息 ,在 admin 模块 User 控 
制 器 的 index 方法 中 添加 如 下 页 面 转向 代码 : 


public function indexAction() 
{ 


" this -> redirect( '/adnin/user/list'); 
H 
完成 上 述 全 部 工作 后 ,在 浏览 器 中 输入 http://wmoams. com/admin/user, 即 可 看 到 如 
图 7. 1 所 示 的 页 面 效果 。 
7.2.2 职工 信息 的 有 序 排列 


这 里 只 实现 按 职工 人 职 时 间 对 查询 结果 进行 升降 序 排列 的 功能 。 
查看 上 面 User 模型 中 的 getByPage 方法 的 定义 , 它 的 第 1 个 参数 orderIndex 是 用 来 设 


定 查 询 结果 的 排序 方式 的 ,而 list 方法 中 调用 getByPage 方法 时 带 入 的 第 1 个 参数 是 1t, 所 
以 ,只 要 在 页 面 视图 中 根据 不 同 的 链接 设 定 不 同 的 lt 参数 值 即 可 。 
在 list. phtml 视图 文件 中 添加 如 下 代码 : 


< div class = "looktype"» 
查看 方式 : «a href = "/adnin/user/list/1t/0/page/1" class = "al4"> 
注册 时 间 降 序 </a> 
<a href = "/admin/user/list/lt/l/page/1" class = "a3"> 
注册 时 间 升 序 </a> 


</div> 


7.2.3 职工 信息 的 条 件 查 询 


这 里 只 实现 按 职工 所 属 部 门 的 条 件 查询 。 查 询 中 采用 模糊 查询 的 方式 , 即 用 户 可 以 只 
在 查询 表单 中 输入 “所 属 部 门 ” 中 的 部 分 关键 词 就 可 以 进行 查询 。 例 如 ,要 查询 所 有 “环境 工 
程 学 院 ” 的 职工 ,在 查询 表单 中 输入 “环境 " 即 可 。 

1. 添加 方法 

打开 Zend Studio 集成 开发 环境 ,在 ZF Tool 工具 窗口 中 输入 命令 : 


zf create action search User 1 admin 


在 admin 模块 的 User 控制 器 中 添加 search 方法 。 添 加 代码 如 下 : 


public function searchAction() 


{ 


// 获 取 页 面 参数 
$ keywords = urldecode( $ this - > getRequest() -> getParan( 'keywords')); 
// 开 始 查询 并 返回 查询 结果 
if ( $ keywords != null && trim( $ keywords) != '') ( 
// 查 询 表单 回填 数据 


$ fData = array(); 
$ £Data[ 'keywords'] = $ keywords; 
$ this-» view- » fData- $ fData; 
$users- $this-» employee-» getByLike( $ keywords); 
$ this -> view- > users = $ users; 
$ this -> view- > isShow = 'T'; 

} 

// 设 置 页 面 信息 

$ title= ' 用 户 信息 查询 '; 

$ this —> setPageInfo( $ title, $ title); 

} 


2. 修改 页 面 视图 


打开 application\modules\admin\ views\ scripts\ user\ search. phtml 视图 文件 ,将 原 有 
代码 全 部 删除 ,并 添加 如 下 代码 : 


<br/><br /> 
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< div class = "cell h"»«/div» 
< div class = "searchArea"> 
< form name = form searchProgram" id= "form searchProgram" 
method = "post" action=" 
<?php echo $ this -> baseUrl( '/admin/user/search')?»" 
style = "margin:0px; padding:Opx;" 
onsubmit = "return chkInputSearchProgram( ) "> 
< div class = "cell_h"></div> 
< div class = "pl"> 
关键 字 : < input type = "text" name = "keywords" id= "keywords" 
class = "input" style= "width:300px; height:17px; line- height:17px;" 
<?php if( $ this -> fData!- null):?» value = " 
<?php echo $ this -> fData[ 'keywords']?»"«?php endif;?»/» 
< input type = "submit" value = "查询 " /> 
</div> 
</form> 
</div> 
<?php if( $ this -> isShow == 'T'):?» 
«div class = "cell h"»«/div» 
< table class = "table" align = "center" 


代码 中 的 省 略 部 分 与 前 面 的 list. phtml 视图 文件 相同 。 需 要 特别 强调 的 是 ,search. 
phtml 的 删除 “链接 ”的 href 值 为 : 


<?php echo '/admin/user/delete/id/'. $ user[ 'id']. '/isSearch/T/keywords/\' + encodeURI 
(\''. $ this -> fData[ 'keywords']. \')+\"" 


在 查询 表单 输入 关键 字 后 的 页 面 效果 如 图 7. 3 所 示 。 
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图 7.3 用 户 信息 条 件 查询 


7.2.4 职工 信息 的 添加 


管理 系统 中 的 用 户 注册 分 为 批量 注入 与 单个 用 户 注册 两 种 。 系 统 运行 前 ,由 系统 管理 
员 通 过 文件 一 次 性 注入 职工 信息 ,在 平常 的 管理 中 只 需 添 加 一 些 少量 的 特殊 用 户 。 

1. 单个 添加 

1) 创建 admin 模块 的 User 模型 

打开 Zend Studio 集成 开发 环境 中 的 ZF Tool 工具 ,在 命令 窗口 中 输入 : 


zf create model User admin 
在 admin 模块 中 创建 User 模型 ,并 添加 代码 : 


class Admin Model User extends Zend Db Table 
{ 
protected $ name- 'tb_users'; 
protected $ primary- 'id'; 
public function addByInfo( $ data = array( ) ) { 
$ row= $ this - » createRow() ; 
if(count( $ data) > 0){ 
foreach ( $ data as $ key => $ value) { 
$ row- >$ key= $ value; 
) 
$ row- » save(); 
return $ row-> id; 
) 
else( 
return null; 


) 


} 

上 述 代 码 在 User 模型 中 添加 了 一 个 名 为 addByInfo 的 方法 ,该 方法 完成 职工 信息 的 数 
据 库 插入 。 注 意 ,Zend Tool 工具 生成 的 模型 类 的 名 称 为 Admin_Model_User, 它 的 前 组 与 
默认 default 中 的 Wm_ 不 同 。 如 果 要 让 系统 在 使 用 该 类 时 能 够 自动 搜索 ,需要 在 admin 模 
块 中 添加 启动 文件 Bootstrp. php ,该 文件 位 于 application\modules\admin\ 目 录 下 。 


class Admin Bootstrap extends Zend Application Module Bootstrap 


public function init(){ 


} 
} 
注意 ,其 基 类 与 默认 模块 中 的 启动 类 基 类 不 同 。 
2) 创建 控制 器 方法 
在 admin 模块 的 User 控制 器 中 添加 register 方法 ,并 添加 代码 : 


public function registerAction() 
{ 
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$ this -> view 一 > isShow- 'F'; 

if( $ this -> getRequest() - > getParan( 'admin'))( 
$ this -> view- > isShow= 'T'; 
// $ this -> render(); 

} 

$ formUser = new Wm Form User(); 

$ formUser - > removeElement( netname'); 


$ £ornUser -> removeElement( 'role'); 
$ fornUser - > getElement('submit') -> setLabel( ' 提 交 '); 


if( $ this - > getRequest() - > isPost()){ 
if( $ formUser- » isValid( $ POST))( 
$ userDate- $ fornUser -> getValues(); 
$ modelUser = new Admin Model User(); 
$ userDate[ 'password'] = nd5( $ userDate[ 'password']); 
$ newUser = $ modelUser - » addByInfo( $ userDate); 
if( $ newUser)( 
$ this - » redirect( '/adnin/user/detail/id/'. $ newUser); 
}else{ 
throw new Zend Exception( ' 注 册 用 户 失 败 ! '); 
exit(); 


) 

$ this -> view- » formUser = $ formUser; 

// 设 置 页 面 信息 

$ title= ' 职 工 个 人 注册 '; 

$ this ->_setPageInfo( $ title, $ title); 
) 


3) 修改 视图 
打开 register 对 应 的 视图 文件 register. phtml, 编 写 代 码 : 


«div class = "cell_h"></div > 
< div class = "searchArea"> 

< form name = "form searchProgram" id = "form searchProgram" method = "post" action = 
"/admin/user/register" style = "margin:0px; padding:0px;" onsubmit = "return chkInputSearchProgram( )"> 

< div class = "cell_h"></div> 

< div class = "pl"> 

注册 操作 员 : < input type = "text" name = "admin" id = "keywords" class = "input" readonly 

style = "width:300px; height:17px; line- height :17px;" value = "<?php echo $ this -> user 一 > 
getIdentity() -> username ?>" /> < input type = "submit" value = "确认 " /> 

</div> 

</form> 
</div> 
<?php if( $ this -> isShow == 'T'):?> 
<div class = "cell_h"></div> 
< table class = "table" align = "center"> 

<tr> 


«th style = "width:30px;height:24px; border:lpx solid # BDE2FD; 
background:url('/images/title bg1.gif');"> 标 签 </th> 
< th style = "height:24px; border:lpx solid # BDE2FD; 
background:url('/images/title bg1.gif');"> 内 容 </th> 
«th style = "width:250px; height:24px; border:lpx solid # BDE2FD; 
background:url('/images/title bg1.gif');"> 说 明 </th> 
</tr> 
«tr» 
< td colspan- "2" style=" border:lpx solid # BDE2FD; 
text- align:left;"»«?php echo $ this -> formUser; ?></td> 
< td style = "height:250px; border:1px solid # BDE2FD; 
text - align: left; "> &nbsp;</td> 
</tr> 
</table> 
<?php endif; ?> 


<div class = "cell_h"></div > 


职工 信息 添加 页 面 效果 如 图 7.4 所 示 。 这 里 没有 处 理 表单 输入 错误 时 的 提示 信息 ,请 
参照 第 6 章 的 相关 章节 。 
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4) 职工 详细 信息 

职工 信息 添加 成 功 后 ,页 面 跳 转 到 该 职工 的 详细 信息 页 面 ,可 以 在 这 里 校对 其 全 部 
信息 。 

在 admin 模块 的 User 控制 器 中 添加 detail 方法 .并 修改 视图 ,效果 如 图 7.5 所 示 。 

在 Zend Studio 集成 开发 环境 中 打开 application\modules\admin\controllers 目录 下 的 
User 控制 器 文件 ,在 detail 方法 中 添加 如 下 代码 : 


public function detailAction() 
{ 
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$ id= $ this -> getRequest() —> getParan( 'id'); 


$ formUser -> removeElement( 'submit'); 
$ employee = $ this- » employee -> find( $ id) -> current(); 
$ employee = $ employee -» toArray(); 
$ formUser -> populate( $ employee); 
$ this 一 > view- > formUser = $ formUser; 
$ this -> view- > employee = $ employee[ 'username']; 
// 设 置 页 面 信息 
$ title= ' 职 工 详细 信息 '; 
$ this-» setPageInfo( $ title, $ title); 
) 


打开 application NmodulesVadmin V viewsVscriptsVuser 目录 下 的 detail. phtml 视图 文件 ， 
并 编写 代码 : 


<br /><br /> 

« h2 align = "center"><?php echo $ this -> employee?» &nbsp;&nbsp; ---- &nbsp;&nbsp; 个 人 详细 
信息 </h2 > 

<hr /> 

<?php echo $ this -> formUser;?» 
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2. 批量 添加 


职工 信息 的 批量 添加 通过 文件 来 完成 。 为 了 系统 信息 的 安全 与 系统 操作 的 可 核查 ,在 
批量 添加 过 程 中 ,文件 被 选 定 后 ,系统 默认 将 文件 上 传 至 服务 器 。 为 了 简便 ,这 里 只 实现 由 
Microsoft Office Excel 提供 的 职工 信息 登记 文件 。 

1) 创建 方法 

在 admin 模块 的 User 控制 器 中 添加 insert 方法 ,并 添加 代码 : 


public function insertAction() 


{ 


$ addNum = 1; 

$ addLastid = 0; 

$ this -> view- > isShow- 'F'; 

if ( $ this - > getRequest() -> isPost()){ 


$ adapter = new Zend File Transfer Adapter Http(); 
$ path = APPLICATION PATH. '/resources/ 
'. date( 'Y - m- d). '/userInformation/'; 


$ folder = new Zend Search Lucene Storage Directory Filesystem( $ path); 


) 


$ fileInfo- $ adapter — > getFileInfo(); 
$ extName = 'csv'; 
$ filename = 'admin'. $ this -> user- » getIdentity() -> id.time(). '. '. 
$ extName; 
$ adapter - > addFilter( 'Rename',array( 
'target' -» $ filename, 'overwrite' => true) ) ; 

$ adapter - » setDestination( $ path); 
$ adapter -> addValidator( 'Extension', false, array( 'csv')); 
if( $ adapter - » receive())( 

$ file- $ path. $ filename; 
}else{ 

throw new Zend Exception('X ff E f£ A We); 

exit(); 


$ modeUser = new Admin Model User(); 
if (( $ handle- fopen( $ file, 'r')) !== FALSE) ( 
$ columns = fgetcsv( $ handle, 1000, ","); 
) 
while (( $ data = fgetcsv( $ handle, 1000,",")) !-- FALSE) ( 
$ info- array combine( $ columns, $ data); 
$ addLastid = $ modeUser - > addByInfo( $ info); 
$ addNum++; 
} 
fclose( $ handle); 
$ select = $ this- » employee -> select(); 
$ select -> where( 'id > ?', $ addLastid- $ addNum - 1); 
$ select -> limit( $ addNun) ; 
$ users = $ modeUser -> fetchAll( $ select); 
$ users = $ users - » tohrray() ; 
$ this -> view- > users = $ users; 
$ this -> view- > isShow= 'T'; 


// 设 置 页 面 信息 
$ title= ' 职 工 批量 注册 '; 
$ this—> setPageInfo( $ title, $ title); 
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以 上 代码 实现 了 文件 上 传 ,数据 的 读 取 与 插入 等 一 系列 功能 ,当然 可 以 用 函数 分 成 多 个 
功能 模块 ,但 为 了 大 家 学 习 方便 ,我 们 把 它们 放 在 了 一 个 函数 中 。 对 于 代码 的 含义 将 在 下 一 
章 中 详细 介绍 ,这 里 先 把 效果 做 出 来 。 

2) 修改 视图 

打开 application\modules\admin\ views\ scripts\ user\ insert. phtml 视图 文件 ,将 代码 
修改 为 : 


< div class = "nav"> 
«ul» 
< li class = "1i2"> 
<a href = "/adnin/user/list/flag/all/1t/0/page/1" 
class = "a3"> 信 息 管理 </a> 
</li> 
< li class = "1i2"> 
<a href = "/adnin/user/search" class = "a3"> 信 息 查询 </a> 
</li> 
< li class = "1i2"> 
<a href = "/admin/user/register" class = "a3"> 个 人 注册 </a> 
</li> 
< li class = "1li1"> 
<a href = "/admin/user/insert" class = "a3"> 批 量 注 册 </a> 
</li> 
</ul> 
</div> 
< div class = "cell_h"></div> 
<div class = "searchArea"> 
< form name = "form insert" id= "form insert" onsubmit = 
"javascript:return window. confirm( 
"确认 注入 该 文件 中 的 职工 信息 吗 ?')?true:false" 
method = "post" enctype = "multipart/form- data" 
action = "/admin/user/insert" style "margin:Üpx; padding: 0px; "> 
< div class = "cell h"»«/div» 
< div class = "pl"> 
请 选择 文件 : < input type = "file" name = "fileName" id = "file" class = "input" style = "width: 
300px; height:20px; line- height:20px;" /» 
< input type = "submit" style = "font- size: 10px; width:60px;height:20px; 
line- height:20px;padding:0" value = "确定 " /> 
</div> 
</form> 


</div> 


批量 添加 注册 文件 时 数据 注入 完成 后 的 效果 分 别 如 图 7. 6 和 图 7.7 所 示 。 
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图 7.7 用 户 信息 批量 注入 完成 页 面 


7.2.5 职工 信息 的 删除 
在 admin 模块 的 User 控制 器 中 添加 delete 方法 ,并 编写 代码 : 


public function deleteAction() 


i 


// 页 面 编 码 

header( 'content - type:text/html; charset = utf - 8'); 

// 去 掉 视 图 和 布局 

$this-» helper -> layout() - > disableLayout(); 

$ this-- helper -> viewRenderer - > setNoRender() ; 

// 接 收 页 面 参数 

$ id= $ this -> getRequest() - > getParam( 'id'); 

$ isSearch= $ this -> getRequest() — > getParam( 'isSearch'); 
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$ select = $ this- » employee- » select(); 
$ select - » where( 'id 7 ?', $ id); 
$ result = $ this- » employee - > fetchRow( $ select); 
$ result -> delete(); 
// 返 回 
if ( $ isSearch != null && $ isSearch== 'T') { 
$ this -» redirect( '/admin/user/search/keywords/'. 
urlencode( $ this —» request» getPeram( 'keywords:))); 
) eise ( 
$ this - » redirect( '/admin/user/list/1t/0/page/1'); 
) 
exit(); 
) 


删除 职工 信息 不 需要 跳 转 到 另外 一 个 页 面 , 只 需要 把 结果 在 当前 页 面 上 显示 出 来 就 可 
以 了 。 也 就 是 说 ,删除 操作 完成 后 要 能 看 到 记录 从 页 面 上 消失 。 
注意 : 删除 操作 可 能 是 在 全 部 信息 显示 页 面 ; 也 可 能 是 在 查询 页 面 ,删除 操作 完成 后 ， 
页 面 类 型 不 能 改变 。 所 以 ,在 list. phtml 和 search. phtml 页 面 中 的 “删除 ”链接 其 href 值 是 
一 样 的 ,请 大 家 特别 注意 。 


用 户 进 入 系统 主页 后 ,可 以 对 自己 的 信息 进行 适当 括 查 看 、 更 改 部 分 信息 等 。 


下 面 就 来 完成 这 方面 的 功能 。 
7.3.1 创建 用 户 信 息 面板 


当 用 户 通过 登录 认证 后 ,进入 系统 前 台 主 页 ,在 该 页 面 中 应 该 显示 用 户 的 相关 信息 , 例 
如 职工 姓名 、 所 属 部 门 、 角 色 等 。 如 果 用 户 具有 进入 系统 后 台 管 理 中 心 的 权限 ,还 应 该 显示 
进入 管理 中 心 的 链接 。 另 外 ,用 户 注销 的 链接 也 是 必 不 可 少 的 。 

打开 Zend Studio 集成 开发 环境 ,双击 打开 项 目 wmProject 的 application \ layouts V 
header. phtml 视图 文件 ,添加 代码 : 


<?php 
$ auth = Zend_Registry: :get( 'auth'); 
$ user = $ auth-> getIdentity(); 
switch ( $ user - » role) { 
case 'admin': $ role = ' 系 统管 理 员 ';break; 
case 'edit': $ role- ' 部 门 管理 员 ';break; 
default: $ role- ' 普 通 员工 ';break; 
} 
?> 
<div id= "header"> 
<div id= "logo" 
< img src = "/images/logo. jpg"> 
<div id= "usepanel"> 
今天 是 : <?php echo date('Y 4E m H d H ', tine()) ?> &nbsp; &nbsp; &nbsp; 
欢迎 您 : <a href = '/user/account/id/<?php echo $ user -> id ?>'> 
<?php echo $ user -> username ?></a> &nbsp; &nbsp; &nbsp; 


所 属 部 门 : <?php echo $ user -> department ?> &nbsp; &nbsp; &nbsp; 
您 是 : «?php echo $ role ?> &nbsp; &nbsp; &nbsp; &nbsp; 
<?php if( $ user -> role == 'admin'):?» 
<a href = '/adnin/user/list'» 
进入 系统 后 台 管 理 中 心 </a> &nbsp; &nbsp; &nbsp; &nbsp; 
<?php endif;?» 
<a href = '/user/logout' > 注销 </a> 
</div> 
</div> 
</div> 


第 1 一 9 行 代码 通过 注册 表 对 象 auth 取出 用 户 认证 信息 ,并 存放 在 User 中 ,接着 将 用 
户 角色 用 通俗 的 术语 输出 ; 其 后 的 代码 表示 用 户 信息 面板 ,这 里 显示 当前 日 期 .用户 姓名 
(职工 姓名 )、 所 属 部 门 以 及 用 户 角 色 , 可 以 根据 具体 情况 对 显示 内 容 做 适当 的 调整 。 代 码 中 
用 户 姓 名 和 所 属 部 门 是 从 登录 认证 信息 中 直接 取出 的 ,并 且 给 用 户 姓名 添加 了 超级 链接 ,让 
用 户 单 击 自己 的 姓名 可 以 查看 个 人 详细 信息 。 

页 面 效果 如 图 7. 8 所 示 。 
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图 7.8 用 户 信息 面板 效果 图 
7.3.2 个 人 信息 主页 的 设计 


当 用 户 单 击 用 户 信息 面板 中 的 姓名 或 选择 “个 人 办 公 ”|“ 个 人 名 片 ” 菜 单项 时 ,页 面 跳 转 
到 用 户 个 人 信息 主页 ,在 这 里 可 以 查看 个 人 全 部 信息 ,也 可 以 对 某 些 信息 进行 修改 。 
完成 后 的 效果 如 图 7.9 所 示 。 
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图 7.9 用 户 个 人 详细 信息 
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1. 创建 控制 器 方法 
为 User 控制 器 添加 account 方法 。 打 开 Zend Studio 集成 开发 环境 中 的 ZF Tool 工具 
窗口 ,输入 命令 : 


zf create action account User 


注意 : 操作 是 在 默认 模块 中 进行 的 ,User 后 面 的 模板 名 default 可 以 省 略 。 在 account 
方法 中 添加 代码 : 
public function accountAction() 
{ 
$ id= $ this -> getRequest() -> getParam( 'id'); 
if(! $ id){ 
$ id= $ this- >_user -> getIdentity() -> id; 
) 
$ modelUser = new Wm Model User(); 
$ user = $ modelUser - > getUser( $ id); 
$this-» view- » user- $ user; 


) 
上 述 代 码 中 的 让 语句 是 考虑 用 户 以 选择 “个 人 办 公 ”|“ 个 人 名 片 ” 菜 单项 的 方式 进入 个 
人 信息 主页 的 情况 。 
代码 中 的 _user 是 在 User 控制 器 中 定义 的 变量 ,用 于 存放 用 户 认证 信息 。 其 定义 及 初 
始 化 代码 如 下 : 
class UserController extends Zend Controller Action 
{ 
protected $ user- null; 
public function init() 
{ 
$ auth= Zend_Registry: :get('auth'); 
if( $ auth - > hasIdentity()){ 


$this-» user- $ auth; 


} 


) 


2. 创建 用 户 模型 

在 User 控制 器 的 account 方法 中 通过 传递 用 户 id 利用 用 户 模型 的 getUser 方法 从 数 
据 库 中 查询 到 登录 用 户 的 全 部 信息 ,所 以 需要 创建 用 于 处 理 业务 逻辑 的 User 模型 。 请 大 
家 注意 ,我 们 在 编程 的 过 程 中 始终 是 围绕 M-V-C 的 模式 进行 的 ,当然 顺序 有 时 会 不 一 样 , 抓 
住 这 个 关键 点 ,思路 会 更 清晰 一 些 。 

在 Zend Studio 集成 开发 环境 的 ZF Tool 工具 窗口 中 输入 命令 : 

zf create model User 


在 User 模型 中 添加 代码 : 


class Wm Model User extends Zend Db Table 
{ 


protected $ name- 'tb users'; 


public function getUser( $ where) 


{ 
if (is numeric( $ where) ){ 
$ row- $ this - » find( $ where) -> current(); 
) 
if (is array( $ where))( 
$ select = $ this -> select(); 
if (count( $ where) > 0){ 
foreach ( $ where as $ key=> $ value){ 
$ select 一 > where( $ key. " = ?", $ value); 
) 
) 
$ row7 $ this - » fetchRow( $ select); 
) 
if ($ row)( 
return $ row; 
) 
else( 
return null; 
) 
} 


) 


上 述 代码 定义 了 一 个 根据 条 件 查询 用 户 信息 的 getUser 方 法 , 当 传人 的 参数 为 数值 时 ， 
说 明 是 用 主键 直接 查找 ,对 于 find 方法 的 使 用 已 在 第 5 章 中 做 了 详细 的 介绍 。 对 数据 库 的 
查询 操作 可 以 使 用 不 同 的 函数 ,但 大 家 要 注意 各 个 函数 的 返回 值 的 类 型 差异 ,这 关系 到 数据 
在 视图 中 的 输出 。 

3. 设计 视图 页 面 

从 图 7.7 所 示 的 页 面 效 果 可 以 看 到 ,用 户 个 人 信息 页 面 分 为 上 、 下 两 个 区 ,上 区 为 操作 
区 ,显示 了 当前 用 户 能 进行 的 操作 ; 下 区 为 信息 详细 显示 区 ,采用 了 选项 卡 的 页 面 形式 ,将 
信息 进行 了 分 类 ,分 别 是 基本 信息 、 工 作 信息 、 联 系 信息 以 及 其 他 信息 。 

选项 卡 页 面 的 实现 要 结合 CSS 样式 表 与 JavaScript 来 完成 ,由 于 篇 幅 的 关系 ,我 们 不 
做 详细 介绍 ,请 大 家 查询 源码 。 视 图 部 分 代码 如 下 : 


< div class = "menu3"> 
<ul> 
<li id= "threel" onmouseover = "setTab( 'three',1,4)" class = "hover"> 
基本 信息 </1i> 
<li id = "three2" onmouseover = "setTab( 'three',2,4)"> 工 作 信息 </1i> 
«li id- "three3" onmouseover = "setTab( 'three', 3,4)"> 联 系 信息 </1i> 
<li id = "three4" onmouseover = "setTab( 'three', 4,4)"> 其 他 信息 </1i> 
</ul > 
< div class = "clear"></div> 
</div> 
<div class = "con t" id= "con three 1" > 
«table class = "info"> 
«tr» 
«th width = "15g% "> 标签 </th> 
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«th width- "35$ "> 内 容 </th> 
«th width= "15 % "> 标签 </th> 
«th width= "35$ "> 内 容 </th> 
/try 
<tr><td> 姓 名 : </td> 
<td><?php echo $ this -> user[ 'username']?></td> 
<td> 年 龄 : </td> 
<td><?php echo $ this ->user['age']?></td> 
</tr> 
<tr><td> 性 别 : </td> 
<td><?php echo $ this ->user['sex']?' 男 ':' 女 '?></td> 
<td> 民 族 : </td> 
<td><?php echo $ this ->user['nation']?></td> 
</tr> 


</table> 
<div class = "clear"></div> 
</div> 


7.3.3 个 人 信息 的 修改 


用 户 个 人 可 以 对 某 些 信息 进行 修改 ,例如 密码 、 联 系 方式 、 个 人 简介 等 。 用 户 信 息 的 修 
改 使 用 表单 来 完成 ,当然 还 是 用 之 前 创建 的 user 表单 而 无 须 新 建 。 

1. 修改 表单 

个 人 信息 中 的 用 户 照片 是 通过 文件 上 传 得 到 的 。 为 了 在 信息 修改 页 面 也 能 看 到 用 户 照 
片 ,我 们 将 第 6 章 创建 的 user 表单 做 一 下 调整 ,代码 如 下 : 


// 用 户 照片 

$ photo = $ this -> createElement('image', 'photo'); 
$ photo - > setLabel('Bi H : '); 

$ photo - > setAttrib('src', '/images/nophoto. gif'); 
$ this - > addElement( $ photo); 

// 照 片上 传 

$ avatar = $ this -> createElement( file', avatar'); 
$ avatar -> setLabel('Bi H E f£: "); 

$ avatar -> addValidator( 'Size', false, 2048000); 

$ avatar -> addValidator( 'Count', false, 1); 

$ avatar - » setRequired(false); 

$ this - » addElement( $ avatar); 


由 于 Zend. Form 表单 的 file 表单 元 素 需 要 使 用 File 装饰 器 来 修饰 ,所 以 要 在 表单 文件 
的 后 面 加 上 文件 表单 元 素 装饰 器 代码 : 


$ this 一 > setElementDecorators(array( 


)); 
$ this -» getElement ( 'avatar') -> setDecorators( 
array( 
Tile, 


array(array( 'data' => 'HtmlTag'),array('tag'=> 'td')), 
array( 'Label',array( 'tag' => 'th')), 
array(array( 'row' => 'HtmlTag'),array('tag'=> 'tr')) 
) 
); 


$ this 一 > setDecorators(array( 


请 务必 注意 添加 代码 的 位 置 。 
2. 添加 方法 
在 Zend Studio 集成 开发 环境 的 ZF Tool 工具 窗口 中 输入 命令 : 


zf create action update User 


在 默认 模块 的 User 控制 器 中 创建 update 方法 ,编写 代码 : 


public function updateAction() 


$ auth = Zend Registry: :get('auth'); 
$ id= $ auth- » getIdentity() -> id; 


$ formUser = new Wm Form User(); 


$ fornUser - > removeElenent( 'avatar'); 
// 修 改 “ 登 录 ” 按 钮 的 标签 为 "提交 " 
$ formUser - > getElement( 'submit') -> setLabel( ' 提 交 '); 
$ modelUser = new Wm Model User(); 
$ message = ''; 
if( $ this - > getRequest() 一 > isPost( ) ) { 
if ( $ formUser -> isValid( $ POST))( 
$ formData = $ formUser -> getValues(); 
$ validUser = $ modelUser — > validUser( $ formData[ 'netname']); 
// 系 统 中 的 登录 名 不 能 相同 
if(! $ validUser)( 
$ formData[ 'password'] = md5( $ fornData[ 'password']); 
unset( $ formData[ 'password2']); 
unset( $ formData[ 'photo']); 
$ where 'id- '. $ id; 
$ modelUser - > update( $ formData, $ where); 
}else{ 
$ message . = ' 对 不 起 ,系统 中 已 经 存在 同名 用 户 ! 
}else{ 
// 错 误 提示 信息 的 提取 
$ arrayMessage = $ formUser - » getMessages(); 
if (isset( $ arrayMessage[ 'netname'][ '0'])) { 
$ message .=' '. $arrayMessage[ 'netname'][ '0']. '< br />'; 


) 
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) 
$ user = $ modelUser -> find( $ id) -> current(); 
$ formUser - » populate( $ user -> toArray()); 
if( $ user[ 'avatar'])( 
$ formUser — > getElement ( 'photo') — > setAttrib('src', $ user[ 'avatar']); 
} 
$ this -> view- > user = $ user; 
$ this -> view- > formUser = $ formUser; 
$ this -> view — > message = $ message; 
} 
3. 修改 视图 
打开 application\views\scripts\user\ update. phtml 视图 文件 ,添加 代码 : 
<br /><br /> 
«?php 
echo "< h3»". $ this - » user - > username. "个 人 信息 </h3 >"; 
echo $ this -> formUser; 
?> 
在 图 7.7 所 示 的 个 人 信息 主页 中 单 击 上 区 中 的 “更 改 ” 按 钮 ,转向 个 人 信息 修改 页 面 , 效 
果 如 图 7. 10 所 示 。 
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7.10 用户 信 息 的 更 改 


4. 处 理 表单 

1) 验证 提示 信息 的 显示 

在 update. phtml 中 添加 代码 , 当 验 证 失败 时 ,在 表单 的 下 面 用 红色 集中 显示 错误 提示 
信息 。 


<br /><br /> 
<?php 


echo "< h3 >". $ this->user->username." 个 人 信息 修改 </h3><hr />"; 
echo $ this 一 > formUser; 

?> 

«div style = "color: # ff0000"»«?php echo $ this -> message ?></div> 


修改 User 控制 器 的 update 方法 ,取出 错误 信息 。 


if (isset( $ arrayMessage[ 'netname']['0'])) ( 

$message.-'' '. $arrayMessage[ 'netname'][ '0']. '< br />'; 
} 
if (isset( $ arrayMessage[ 'phone'][ '0'])) ( 

$ message .=' '. $ arrayMessage[ 'phone'][ '0']. '< br />'; 
} 
if (isset( $ arrayMessage[ 'email']['0'])) { 

$message .=' '.$arrayMessage[ 'email']['0']. '< br />'; 
} 
if (isset( $ arrayMessage[ 'avatar']['0'])) ( 

$ message . = '. $ arrayMessage[ 'avatar'][ '0']; 


) 


2) 避免 用 户 登录 名 同名 
用 户 登录 系统 采用 的 是 登录 名 ,也 就 是 所 谓 的 昵称 。 用 户 可 以 根据 自己 的 喜好 来 设置 
昵称 ,但 在 整个 系统 中 它 必 须 是 唯一 的 。 所 以 , 当 用 户 修改 昵称 时 ,应 判断 是 否 与 系统 中 已 


注册 用 户 的 登录 名 同名 。 
在 User 模型 中 添加 方法 ,打开 application\ model\ User. php 模型 文件 ,添加 验证 方法 


及 代码 : 


public function validUser( $ netname) 
{ 
$ select = $ this -> select(); 
$ select - > where( "netname = ?", $ netname); 
$ result = $ this -> fetchRow( $ select); 
if ( $ result -> netname == $ netname) { 
return $ result -> id; 
} 
else{ 
return FALSE; 
} 
} 


在 User 控制 器 的 update 方 法 中 添加 代码 ,完成 同名 验证 : 


if ( $ formUser -> isValid( $ formData))( 
$ validUser = $ modelUser — > validUser( $ formData[ netname']); 


if(! $ validUser)( 


Jelse( 
$ nessage . = ,对 不 起 ,系统 中 已 经 存在 同名 用 户 ! 
) 
Jelse( 
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7.4 忘记 密码 功能 的 实现 


如 果 用 户 忘 记 了 登录 密码 该 如 何 处 理 呢 ? 这 是 系统 设计 中 不 得 不 考虑 的 问题 。 从 前 面 
的 登录 处 理 过 程 中 我 们 知道 ,要 得 到 旧 密 码 是 比较 困难 的 ,因为 存 人 数据 库 中 的 密码 都 是 经 
过 MD5 加 密 处 理 的 。 我 们 把 这 个 经 过 加 密 的 密码 字符 串 返 回 给 用 户 , 他 们 需要 使 用 工具 
破解 之 后 才能 得 到 原来 的 密码 ,显然 这 种 方法 是 不 实用 的 。 更 为 方便 可 行 的 方法 是 ,通过 注 
册 时 的 电子 邮箱 发 给 用 户 一 个 重 置 的 新 密码 , 它 由 系统 自动 生成 的 随机 字符 组 成 ,用 户 使 用 
这 个 新 密码 登录 系统 后 可 以 自行 修改 成 容易 记忆 的 密码 。 

处 理 流 程 : 用 户 需 要 先 通过 一 个 表单 提交 用 户 名 和 邮箱 ,我 们 对 此 用 户 名 及 邮箱 进行 
查询 ,如 果 数 据 库 中 有 该 用 户 , 则 系统 自动 生成 一 个 随机 密码 ,发 送 到 这 位 用 户 的 注册 邮箱 ; 
如 果 没 有 该 用 户 ,返回 相应 的 提示 。 下 面 通 过 这 个 功能 的 实现 向 大 家 介绍 Zend Framework 
中 电子 邮件 的 发 送 方法 。 

1. 添加 链接 

在 登录 页 面 上 添加 一 个 “忘记 密码 ”的 链接 。 打 开 application\views\scripts\user\ 
login. phtml 视图 文件 ,添加 如 下 代码 : 


<div id= "login center"> 


<div style = "position: absolute;right:300px;top:400px"^ 
<a href = "/user/reset - password"> 忘 记 密码 </a> 
</div> 
</div> 


2. 创建 方法 
在 Zend Studio 集成 开发 环境 的 ZF Tool 工具 窗口 中 输入 命令 : 


zf create action resetpassword User 
在 默认 模块 的 User 控制 器 中 添加 resetpassword 方法 ,并 编写 代码 : 


public function resetpasswordAction() 
{ 
$ this-» helper -> layout -> disableLayout(); 
$ nessage = "请 输入 登录 名 及 您 的 注册 邮箱 , 重 置 的 密码 会 发 送 到 该 邮箱 ! 
<br /><br /> 用 新 密码 登录 后 ,进入 个 人 信息 页 面 ,更 改 密码 !"; 
$ formUser = new Wm Form User(); 
$ formUser - » removeElement( 'username'); 


$ formUser - > removeElement( role'); 
$ fornUser - > getElement( 'submit') -> setLabel( ' 密 码 重 置 '); 
if ( $ this -> getRequest() 一 > isPost())( 
if ( $ formUser -> isValid( $ POST))( 
$ modelUser = new Wm Model User(); 
$ where - array( 
"netname' = > $ formUser - > getValue( 'Ünetname'), 


'email'2»$ formÜser-» getValue('ezail') 
) 
$ user = $ modelUser -> getUser( $ where); 


if ( $ user){ 
$ newPassword- $ this—> makePassword(6); 
$ where = 'id= '. $ user - » id; 


$ modelUser -> update(array( 'password' = > 
md5( $ newPassword)), $ where); 
set time limit(0); // 不 限时 间 , 默 认 时 间 为 30 秒 
$ mailTransport = new Zend Mail Transport Smtp( 
'smtp.163.com', 
array( 'auth' => 'login', 
"username' => 'w111111', // 邮 箱 用 户 名 
'password' => '19666666', // 邮 箱 密码 
'ssl'=> 'ssl')); 
$ mail = new Zend Mail('utf -8'); 
$ mail -> setBodyHtml('« p> 您 的 密码 被 系统 重 置 为 : . $ newPassword. 
<br /> 建议 您 在 下 次 登录 后 重新 更 改 为 容易 记忆 的 新 密码 。</p>'); 
$ mail -> setSubject( ' 您 在 微 梦 办 公 自 动 化 管理 系统 的 新 密码 '); 
$ mail -> setFrom( wenpingwei(2163.con', ' 微 梦 工 作 室 '); 
$ mail ->addTo( $ user -> email, $ user - > username) ; 
$ mail -> send( $ nailTransport); 
$ this -> redirect('/'); 
} 
}else{ 
$ arrayMessage = $ formUser - > getMessages( ) ; 


} 
$ this -> view- > formUser = $ formUser; 
$ this -> view -> message = $ message; 


j 
上 述 代 码 中 用 到 的 自 定义 函数 makePassword 产生 6 位 随机 密码 。 代 码 如 下 : 


protected function makePassword( $ length) 
( 
$ possible = "0123456789abcdefghi jk1mnopqrstuvwxyz 
ABCDEFGHIJKLMNOPOQRSTUVWXYZ" ; 
$ str=""; 
while(strlen( $ str) < $ length) { 
$ str . = substr( $ possible, (rand() % strlen( $ possible)),1); 
} 
return( $ str); 


) 


3. 修改 视图 文件 
依照 登录 界面 的 形式 设计 密码 重 置 界面 ,效果 如 图 7. 11 Bro 
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7.11. 用 户 密码 的 重 置 


7.5 本 章 小 结 


本 章 通过 用 户 信息 管理 功能 的 实现 实例 ,介绍 了 Zend Framework 框架 的 模块 技术 ,以 
及 数据 库 的 增 、 删 、 改 、 查 等 详细 操作 方法 ,既是 对 第 5 章 内 容 的 进一步 阐述 与 扩充 ,也 是 对 
前 面 其 他 章节 知识 的 实际 应 用 ,做 到 了 温 故 而 知 新 。 

学 习 本 童 应 重点 掌握 Zend Framework 的 自 定义 模块 的 创建 方法 、 目 录 结 构 及 其 与 默 
认 模 块 的 关系 。 对 于 数据 库 的 操作 ,除了 要 熟练 掌握 常用 的 基本 操作 外 ,还 要 重点 掌握 文中 
所 介绍 的 通过 文件 批量 注入 数据 的 方法 。 另 外 ,用 户 密码 重 置 中 的 邮件 操作 也 是 值得 关注 
的 一 个 知识 点 。 


第 8 章 公文 信息 管理 模块 


公文 管理 是 办 公 自 动 化 管理 系统 的 核心 功能 ,是 实现 企业 信息 化 管理 的 基础 。 公 文 的 
种 类 有 很 多 ,包括 通知 、 决 定 、 报 告 . 纪 要 请示 、 函 等 。 这些 公文 的 内 容 、 缓 急 程 序 以 及 保密 
级 别 虽 然 有 所 不 同 , 但 结构 基本 上 是 相似 的 ,可 以 用 一 个 统一 的 数据 模型 对 它们 进行 管理 。 

本 章 实现 系统 公文 的 管理 功能 ,包括 公文 的 拟稿 . 校 核查 询 、 删 除 等 ,以 此 介绍 Zend 
Framework 的 分 页 显示 组 件 Zend_Paginator ,文件 组 件 Zend. File 的 使 用 。 


8.1 功能 预览 


办 公 自 动 化 系统 中 的 公文 是 企业 办 公 过 程 中 信息 交流 的 载体 ,对 它 的 管理 要 求 做 到 规 
范 、 准 确 、 快 捷 与 安全 。 规 范 性 是 指 公 文 的 拟稿 .审核 ,发 布 \ 收 件 、 办 结 等 流程 要 符合 企业 管 
理 规范 ; 准确 性 是 指 公文 送 达 目标 的 精准 ; 快捷 则 要 求 系统 功能 要 能 满足 用 户 及 时 获取 、 
保存 公文 信息 的 便利 。 

由 于 教材 篇 幅 以 及 写作 重点 的 关系 ,下 面 只 实现 一 些 公文 管理 的 基本 功能 。 

(1) 系统 主页 的 公文 显示 ,如 图 8. 1 所 示 。 
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8.1 公文 在 系统 主页 上 的 显示 效果 
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(2) 公文 管理 主页 上 的 分 类 显示 ,如 图 8.2 所 示 。 
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图 8.2 公文 在 系统 主页 上 的 显示 效果 
(3) 个 人 公文 管理 页 面 效果 ,如 图 8. 3 所 示 。 
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图 8.3 个 人 公文 管理 页 面 效果 
(4) 公文 拟稿 页 面 效果 ,如 图 8.4 所 示 。 
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8.4 公文 拟稿 页 面 效果 


8.2 数据 库 设计 


数据 库 是 系统 信息 永久 保存 的 方式 之 一 ,关系 到 信息 的 查询 .系统 的 运行 效率 等 诸多 方 
面 。 为 了 简便 ,本 系统 公文 采用 统一 的 数据 表 进 行 管 理 。 

根据 第 3 章 的 总 体 设计 及 业务 逻辑 的 需要 ,公文 信息 管理 数据 表 由 “公文 信息 ” 表 “ 部 
门 信息 ” 表 和 “公文 类 型 " 表 组 成 。 


1. 公文 信息 表 


打开 phpMyAdmin 数据 库 管理 工具 ,在 db_wmoams 数据 库 中 新 建 名 为 tb_docs 的 数 
据 表 ,其 字段 含义 见 表 8. 1, 字 段 属性 如 图 8. 5 所 示 。 


表 8.1 tb docs 数据 表 的 字段 说 明 


字 段 名 说 明 
id 自 增 变量 ,主键 ,公文 在 系统 中 的 唯一 标识 
fileno 公文 编号 
uid 拟稿 人 
checkid 审核 人 
title 公文 标题 
keyword 关键 词 
typeid 公文 类 型 ID 
body 公文 内 容 
attach 公文 附件 
fromdepart 发 文部 门 
todepart 收文 部 门 


d oo 3 
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Ej 
字 ERA 说 明 
status 公文 状态 
createtime 发 布 时 间 
endtime 公文 处 理 截止 时 间 
suggest 是 否 允许 意见 反馈 
secret 保密 级 别 
urgency 公文 缓急 等 级 
tododepart 公文 待 办 部 门 
doingdepart 公文 在 办 部 门 
donedepar 公文 办 结 部 门 
BF 类 型 排序 规则 Et 空 默认 S 
id int(10) UNSIGNED d Æ AUTO INCREMENT 
fileno warchar20) utf8 general ci 是 NULL 
uid int(10) UNSIGED 是 0 
checkid int(10) UNSIGNED 是 NULL 
title varchar(255) utf8 general ci 是 NULL 
keyword ^ varcha(20) utf8 general ci 是 NULL 
typeid int(10) UNSIGNED 是 NULL 
body longtext — utf8 general ci * NULL 
attach varchar(100) utf8 general ci 是 NULL 
fromdepart | int(10) UNSIGNED 是 NULL 
todepart int(10) UNSIGNED 是 NULL 
status tinyint(4) 是 1 


createtime — int(11) 是 0 
endtime int(11) 是 NULL 
suggest  tinyint(4) NULL 
secret tinyint(4) 0 
urgency tinyint(4) 0 


tododepart varchar100) utf8 general ci 
doingdepart varchar(100) utfà general ci 
donedepart varchar(100) utf general ci 


Hs da Ha do He Ho 
- 
S 
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8.5 tb docs 数据 表 的 属性 设置 


2. 部 门 信息 表 
在 db_wmoams 数据 库 中 新 建 名 为 tb. depart 的 数据 表 , 其 字段 含义 见 表 8. 2 ,字段 属性 
如 图 8.6 所 示 。 


表 8.2 tb depart 数据 表 的 字段 说 明 


字 RE 说 明 

id 自 增 变量 ,主键 ,部 门 在 系统 中 的 唯一 标识 
dno 部 门 编号 

fid 部 门 所 属 单位 ID 

name 部 门 名 称 


file_prefix 部 门 发 文 前 缀 


类 型 排序 规则 Et ZRU Sb 


id int(10) UnsieveD 否 Æ — AUTO INCREMENT 
dno cha(20) ^ utfB general ci EE 

fid int(10) umo g 无 

name  varchar(50) utf8_general_ci [23 

path — varcha(255) utf8 general ci zx 

file prefix cha(20) — utfü general ci 是 NULL 


3. 公文 类 型 表 


8.6 tb depart 数据 表 的 属性 设置 


在 db_wmoams 数据 库 中 新 建 名 为 tb_doctype 的 数据 表 , 其 字段 含义 见 表 8. 3。 本 系 
统 设置 的 公文 类 型 如 图 8.7 Bros. 


表 8.3 tb doctype 数据 表 的 字段 说 明 


字 段 名 说 明 
id 自 增 变量 ,主键 ,公文 类 型 在 系统 中 的 唯一 标识 
name 公文 类 型 名 称 
-T> * id name 
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图 8.7 系统 公文 类 型 


8.3 公文 信息 显示 


系统 公文 的 输出 ,在 不 同 的 页 面 上 应 该 具有 不 同 的 侧重 点 。 在 系统 主页 上 主要 显示 最 
新 发 布 的 公文 信息 ,如 图 8. 1 所 示 ,让 用 户 进 入 系统 就 能 及 时 了 解 最 新 的 各 种 信息 动态 ; 而 
在 “公文 管理 ”菜单 模块 的 页 面 上 显示 公文 内 容 时 应 进行 适当 的 分 类 ,让 用 户 能 方便 \ 快 捷 地 


找到 与 自己 相关 的 内 容 。 
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8.3.1 模型 与 控制 器 的 创建 


1. 创建 模型 
打开 Zend Studio 集成 开发 环境 ,选择 wmProject 项 目下 的 任何 一 个 文件 或 文件 夹 , 通 
过 菜单 打开 ZF Tool 工具 窗口 ,输入 命令 : 


zf create model Page 


这 里 是 在 默认 模块 default 中 创建 模型 ,Page 模型 名 的 后 面 省 略 了 模块 名 。 

打开 application\models\Page. phtp 模型 文件 ,给 模型 类 添加 基 类 Zend_Db_Table, 并 
添加 对 应 的 数据 库 表 tb_docs 和 主键 字段 id, 这 样 ,模型 Wm_Model_Page 就 变 成 了 一 个 数 
据 库 的 表 模 型 。 如 果 以 id 为 主键 ,这 里 的 主键 设置 是 可 以 省 略 的 ,就 像 我 们 前 面 做 的 一 样 ， 
但 如 果 数 据 表 的 主键 字段 名 不 为 id, 就 可 以 用 这 种 方式 进行 设置 。 设 置 了 主键 ,可 以 方便 地 
H Zend Db 组 件 的 类 方法 find 进行 查询 。 

模型 代码 如 下 : 

class Wm Model Page extends Zend — Db Table 

i protected $ name- 'tb docs'; 

protected $ primary- 'id'; 

) 

上 面 创建 模型 采用 的 是 ZF Tool 工具 ,这 样 做 的 好 处 是 能 自动 生成 目录 结构 并 创建 
PHP 文件 ,并 且 模 型 类 名 是 按照 Zend Framework 的 规则 生成 的 ,可 以 自动 加 载 。 大 家 也 
可 以 手动 添加 目录 及 类 文件 ,如 果 不 使 用 像 上 面 那样 的 类 名 ,在 程序 中 使 用 时 需要 添加 
include 或 require 等 相关 语句 或 函数 ,将 模型 类 引入 到 文件 中 。 

2. 创建 控制 器 

在 集成 开发 环境 的 ZF Tool 工具 窗口 中 输入 命令 : 


zf create controller Document 


在 默认 模块 中 创建 Document 控制 器 。 通 过 ZF Tool 工具 添加 控制 器 不 仅 可 以 自动 生 
成 目录 结构 ,还 可 以 自动 添加 index 方法 以 及 对 应 的 index. phtml 文件 。 

ZF Tool 工具 在 完成 上 述 工作 的 同时 还 在 项 目 wmProject 根 目录 中 生成 了 一 个 名 为 
. zfproject. xml 的 文件 ,该 文件 记录 了 项 目的 资源 名 称 及 目录 。 如 果 要 删除 某 个 资源 ,例如 
要 删除 刚 创建 的 控制 器 Document, 在 删除 控制 器 类 文件 、 视 图 文件 及 文件 夹 的 同时 还 需要 
删除 该 文件 中 有 关 Document 小 节 的 内 容 , 否 则 ,Document 这 个 名 字 就 不 能 再 使 用 了 ,因为 
它 已 经 被 记录 在 资源 里 。. zfproject. xml 文件 是 在 项 目 开 发 过 程 中 使 用 的 ,项 目 完 成 后 可 以 
将 其 删除 。 下 面 是 该 文件 中 的 部 分 代码 : 


< controllerFile controllerName = "Document"> 
< actionMethod actionName = "index" /> 


«/controllerFile» 


< viewsDirectory-^ 


< viewScriptsDirectory> 
< viewControllerScriptsDirectory forControllerName = "Document" > 
< viewScriptFile forActionName = "index" /> 
</viewControllerScriptsDirectory > 
</viewScriptsDirectory > 
< viewHelpersDirectory/> 


8.3.2 系统 主页 公文 的 列表 显示 


从 如 图 8. 1 所 示 的 系统 主页 界面 可 以 看 出 ,这 里 的 公文 是 以 列表 的 形式 输出 的 ,并 且 只 
显示 公文 标题 。 为 了 方便 查看 ,每 篇 公文 的 标题 均 设置 了 超级 链接 , 单 击 链接 可 以 跳 转 到 该 
公文 的 详细 内 容 页 面 ,以 了 解 更 多 的 内 容 。 由 于 主页 幅面 有 限 ,显示 的 内 容 不 可 能 太 多 ,所 
以 ,在 每 个 功能 区 另外 设置 more 链接 ,通过 它 用 户 可 以 查询 到 更 多 的 相关 信息 。 

1. 添加 模型 方法 

打开 applicationVXmodelsV Page. php 模型 文件 ,添加 getPages 方法 ,该 方法 用 于 从 数据 
表 中 获取 多 条 满足 条 件 的 记录 。 代 码 如 下 : 


class Wm Model Page extends Zend Db Table 
{ 
protected $ name- 'tb docs'; 
protected $ primary- 'id'; 
public function getPages ( $ orderIndex, $ where = null, 
$ page= 1, $ itenCountPerPage = 10, $ pageRange = 5) 
{ 
// 生 成 select 对 象 
$ select = $ this -> select(); 
$ select - » where( 'typeid = ?', $ where); 
// 排 序 方式 
if ( $ orderIndex == 0) ( 
$ order = 'createtime desc'; 
} elseif ( $ orderIndex == 1) { 
$ order = 'createtime'; 
} 
$ select - » order ( 'urgency desc'); 
$ select - » order( $ order); 
// 实 例 Zend Paginator 对 象 
$ paginatorAdapter = new Zend Paginator Adapter DbSelect( $ select); 
$ paginator - new Zend Paginator( $ paginatorAdapter); 
$ paginator - > setPageRange( $ pageRange) 一 > 
setItemCountPerPage( $ itemCountPerPage) 一 > 
setCurrentPageNumber( $ page) ; 
return $ paginator; 


) 
由 于 完成 的 功能 相似 ,上 述 代码 与 第 7 章 用 户 管理 模块 中 的 User 模型 的 代码 基本 上 是 
相同 的 ,实际 上 可 以 用 一 些 技术 方案 使 代码 共享 。 这 里 为 了 不 使 问题 复杂 化 ,重新 定义 了 一 
个 新 的 模型 类 。 
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上 述 代 码 中 使 用 了 Zend Framework 的 Zend Paginator 进行 信息 的 分 页 显示 ,在 第 7 
章 中 我 们 已 经 领略 到 了 它 的 方便 与 简捷 ,下 面 详细 了 解 一 下 这 个 类 及 其 常用 方法 。 

2. Zend_Paginator 组 件 

在 Web 开发 过 程 中 ,分 页 是 一 项 非常 麻烦 的 工作 ,页 面 之 间 涉 及 很 多 的 参数 需要 传送 ， 
而 且 应 用 中 一 般 都 存在 着 大 量 的 列表 页 面 ,在 每 个 页 面 需 要 重复 编写 同样 的 代码 很 多 次 , 实 
在 是 一 项 烦琐 的 苗 差 事 。Zend Framework 为 用 户 提供 了 一 个 非常 简便 的 分 页 解决 方案 。 

使 用 Zend_Paginator 组 件 进行 分 页 需要 分 3 个 步骤 来 实施 : 

1) 设置 数据 适配器 

为 了 把 数据 集 在 页 面 上 进行 分 页 显示 ,Zend_Paginator 必须 首先 获取 到 数据 。Zend_ 
Paginator 支持 几 种 常见 的 适配器 ,例如 Array, DbSelect, DbTableSelect 等 。Array 适配器 
使 用 一 个 PHP 数组 ; DbSelect 适配器 使 用 一 个 Zend. Db. Select 实例 ,得 到 一 个 数组 ; 
DbTableSelect 适配器 使 用 一 个 Zend_Db_Table_Select 实例 ,得 到 一 个 Zend_Db_Table_ 
Rowset Abstract 实例 。 这 里 使 用 的 是 DbTableSelect 适配器 。 

在 上 述 代 码 中 , 先 根据 各 类 条 件 构建 了 一 个 Zend_Db_Table_Select 实例 select, 然 后 用 
select 作为 参数 实例 化 Zend_Paginator_Adapter_DbSelect 类 ,这 样 就 得 到 了 一 个 包含 分 页 
数据 的 页 面 对 象 。 注 意 ,此 时 的 对 象 已 不 全 是 从 数据 库 中 查询 到 的 记录 和 集 ,里 面包 含 了 大 量 
的 分 页 信息 。 

2) 设置 页 面 参数 

在 分 页 对 象 创建 好 之 后 ,还 要 给 它 设置 一 些 必要 的 页 面 参数 ,例如 每 页 显示 多 条 数据 、 
分 页 显示 控制 条 中 最 多 显示 多 少 页 、 当 前 是 第 几 页 等 ,这 些 都 是 通过 Zend_Paginator_ 
Adapter_DbSelect 类 的 方法 来 完成 的 。 

在 上 述 代码 中 使 用 了 setPageRange 方法 设置 控制 条 的 页 码 范 围 , 默 认为 5, 即 分 页 控 
制 条 中 最 多 允许 显示 5 个 页 码 , 超 出 的 页 码 要 通过 "上 一 页 ”“ 下 一 页 ”或 “首页 ”“ 尾 页 ” 查 
Ti; 使 用 setItemCountPerPage 方法 设置 每 页 显示 的 数据 数量 ,默认 为 10 条 ; 另外 ,还 使 用 
setCurrentPageNumber 方 法 设置 了 当前 页 码 ,默认 为 第 1 页 。 

3) 创建 分 页 显示 控制 条 视图 文件 

在 Web 应 用 中 有 各 种 各 样 的 分 页 显示 控制 条 ,这 里 采用 第 7 章 中 的 分 页 视图 文件 。 这 
个 文件 是 Zend Framework 使 用 手册 例 程 中 的 代码 经 过 适当 修改 后 得 到 的 ,请 大 家 参考 官 
方 手册 。 

在 分 页 显示 控制 条 视图 文件 编写 好 之 后 ,把 它 放 在 applicationVviewsNscripts 文件 夹 下 
application\views\scripts\partials 目录 下 或 application\views\scripts 目录 下 的 自 建文 件 
夹 下 均 可 ,只 要 在 调用 时 注意 路 径 即 可 。application\views\scripts\partials 文件 夹 是 在 第 4 
章 中 自 建 的 文件 夹 ,里 面 已 经 存放 了 一 个 页 面 控制 视图 文件 ,把 分 页 控制 条 视图 文件 list 
page_Pagination_control. phtml 也 放 在 该 目录 下 。 

分 页 控制 条 视图 文件 准备 好 之 后 ,在 页 面 视 图 中 加 入 如 下 代码 ,显示 分 页 控制 条 。 


<?php echo $ this -> paginationControl( $ this -> paginator, 
'Sliding', 'partials/list_page_pagination_control. phtml', 
?> 


代码 中 的 paginator 为 分 页 适配器 对 象 , Sliding 为 分 页 控制 条 中 页 码 的 滚动 方式 ,第 3 


个 参数 便 是 分 页 控制 条 视图 文件 ,我 们 存放 它 于 partials 目录 下 ,所 以 带 上 了 文件 夹 名 。 

3. 添加 控制 器 方法 代码 

在 第 4 章 中 已 经 完成 了 系统 主页 页 面 的 设计 ,下 面 只 需要 在 Index 控制 器 的 main 方法 
中 添加 代码 ,调用 page 模型 的 getPages 方法 获取 数据 就 可 以 了 。 


public function mainAction() 


( 
$ where = 1; // 通 知 公示 类 型 的 公文 
$ docPagesl = $ this - >_page -> getPages(1, $ where, 1,8); 
$ this—> view—> docPagesl = $ docPagesl; 
$ where = 2; // 最 新 其 他 公文 
$ docPages2 = $ this- » page - »getPages(1, $ where, 1,8); 
$ this -> view- > docPages2 = $ docPages2; 
} 


根据 主页 页 面 大 小 ,设置 每 个 功能 区 最 多 显示 8 条 数据 、 取 第 1 页 的 内 容 。 这 里 只 是 示 
意 性 地 验证 了 程序 的 正确 性 ,具体 的 业务 逻辑 还 需要 用 户 根据 具体 情况 进行 设计 。 每 个 功 
能 区 中 显示 的 数据 也 可 以 任意 设置 ,主页 页 面 可 以 在 高 度 方向 自由 伸缩 。 

代码 中 的 _page 是 自 定义 的 Index 控制 器 变量 ,并 在 Index 的 init 方法 中 初始 化 为 模型 
Wm Model Page 的 实例 对 象 。 如 下 所 示 : 


class IndexController extends Zend Controller Action 
{ 


protected $ _page = null; 
public function init() 
{ 


$ this- >_page = new Wm Model Page(); 
) 


4. 添加 视图 代码 

在 Index 控制 器 的 main 方法 中 得 到 的 页 面 内 容 通过 docPage 变量 传递 到 了 对 应 的 
main. phtml 视图 中 ,需要 在 该 视图 文件 中 添加 代码 ,在 适当 的 位 置 将 公文 标题 显示 出 来 。 

打开 application\views\scripts\index\main. phtml 视图 文件 ,添加 如 下 代码 : 


< div class = "center box" > 
<div id= "iteml"> 


«ul» 
<?php foreach ( $ this - > docPages as $key=> $ page) :?> 
«li»« ing alt- "" src = "/images/xing. gif"» &nbsp; &nbsp; 
«a href = " # "><?php echo $ page[ 'title']?»«/a»«/li» 
<?php endforeach; ?> 
</ul> 
</div> 


doo 
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系统 主页 上 不 需要 显示 分 页 控制 条 ,不 必 添 加 演 染 控制 条 的 代码 ,页 面 效 果 如 图 8. 8 
所 示 。 


+ 关于 申报 湖北 省 科技 厅 科 技 项 目的 通知 
+ 关于 籁 兴 等 同志 任职 的 公示 
+ 清华 大 学 出 版 社 教 村 立项 通知 


”计算 机 科学 与 技术 学 院 学 生 优秀 作品 展示 

* 2014 年 迎新 工作 会 议 

* 迎新 工作 会 议 . 

+ 中 科 院 院士 学 术 讲座 通知 + 《 面 6p 提 程序 设计 教程 (C++ 语言 据 述 )》 第 二 版 出 版 
^ 国字 级 精品 课程 研讨 * 《Visual C++ 程序 设计 与 应 用 教程 少 第 二 版 第 6 次 印刷 


8.8 系统 主页 公文 信息 的 显示 


8.3.3 公文 信息 的 详细 显示 


在 系统 主页 的 各 个 功能 区 中 ,列表 显示 的 公文 标题 都 设置 了 超级 链接 ,用 户 单 击 标题 进 
入 公文 信息 的 详细 显示 页 面 。 

1. 添加 控制 器 方法 

公文 信息 的 详细 显示 由 Document 控制 器 管理 。 打 开 Zend Studio 集成 开发 环境 ,在 
ZF Tool 工具 窗口 中 输入 命令 : 


zf create action docdetail Document 


在 Document 控制 器 中 创建 docdetail 方法 ,并 添加 如 下 代码 : 


public function docdetailAction() 

( 
$ id= $ this -> getRequest() 一 > getParam('id'); 
$ docPage = $ this -» page -> getPage( $ id); 
$ this -» view — > docPage = $ docPage; 

i 


代码 中 的 _page 是 自 定义 的 Document 控制 器 变量 ,其 定义 与 初始 化 和 8.3.2 节 中 
Index 控制 器 的 相同 。 

2. 添加 模型 方法 

在 上 述 控制 器 方法 中 使 用 了 page 模型 的 getPage 方法 ,下 面 编写 该 方法 的 代码 : 


public function getPage( $ where = null) 
{ 
$ select = $ this -> select() -> setIntegrityCheck(false); 
$ select - » from('tb docs','* '); 
if (is numeric( $ where))( 
$ select - > where("tb docs. id- ?", $ where); 
) 
if (is array( $ where) & count( $ where) > 0)( 
foreach ( $ where as $ key 2» $ value)( 
$ select - »where( $ key. '-?', $ value); 
) 


) 

$ select -> join('tb users','tb docs.uid- tb users. id', "username as editname'); 

$ select -> join('tb users as tb check', tb docs.checkid = tb check. id', 'username as 
checkname') ; 

$ select -> join('tb depart', tb docs.fromdepart = tb depart. id', 'name as fromname'); 

$ row- $ this -> fetchRow( $ select); 

if( $ select)( 

return $ row; 


) 
else { 

return null; 
} 


} 


EIR getPage 方法 用 来 获取 公文 的 详细 信息 ,这 里 采用 了 Zend Db Select 的 联合 查询 
方式 。 

所 谓 “ 联 合 查询 ”, 就 是 获取 的 信息 分 别 来 自 多 个 相互 关联 的 数据 表 。 请 大 家 查看 数据 
库 中 的 tb. does 表 , 它 的 uid, checkid, fromdepart 等 字段 的 数据 类 型 均 为 int。 这 就 是 说 字 
段 里 存储 的 是 数值 ,分别 代表 ”拟稿 人 ”发 布 人 ?及 “发布 部 门 的 id。 但 是 在 视图 中 ,这 些 
字段 是 不 能 以 数字 的 形式 输出 的 ,而 要 显示 各 数字 所 代表 的 “名 字 ”。 例 如 ,在 输出 “拟稿 人 ” 
的 时 候 要 通过 tb. docs 表 中 字段 uid 的 值 查找 tb. uses 表 中 的 id, 得 到 tb. uses 表 中 的 字段 
name, 也 就 是 这 个 人 的 名 字 。 

代码 中 的 join 函数 是 在 Zend. Db. Select 类 中 执行 联合 查询 的 方法 ,调用 该 方法 要 带 
3 个 参数 。 其 中 ,第 1 个 参数 是 联合 表 名 ; 第 2 个 参数 是 联合 查询 的 条 件 ; 第 3 个 参数 是 查 
询 的 字段 。 对 于 上 述 代码 来 说 ,联合 查询 执行 完毕 后 ,得 到 的 记录 除 主 表 tb. docs 中 的 全 部 
字段 外 ,还 添加 了 editname,checkname 以 及 fromname 3 个 字段 ,所 以 在 下 面 的 视图 中 通过 
这 些 字段 可 以 获取 到 相应 的 名 称 。 代 码 中 的 as 是 定义 的 别名 。 

3. 修改 视图 文件 

打开 application\views\scripts\ document V docdetail. phtml 视图 文件 ,添加 如 下 代码 ， 
显示 公文 的 详细 信息 。 

<style> 

<! -- 

.title5{text ~ align:center; border - bottom:1px dashed & cacaca; padding:0 0 15px 0; margin- 

bottom:15px;] 

.title4( font- size:22px; text- align:center; line- height:50px; font - weight:600) 

. format(margin- left:50px] 

p(font- size:l4px; line- height:30px; } 

enm. 

</style> 

<br /><br /> 

< h2 class = "title4"><?php echo $ this -> docPage[ 'title'];?></h2 > 

< div class = "title5"> 

«?php 
echo "< span > 发 布 部 门 : ". $ this - »docPage[ '£romname']. "</span>"; 
echo "< span class = 'fornat > 发 布 时 间 :". 
date('Y-m- d', $ this— > docPage[ 'createtime'])."</span>"; 
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?> 
«/div» 
«p»«?php echo $ this - > docPage[ 'body'];?» «/p» 
«hr /> 
«?php 

echo "< span > 文件 编号 : ". $ this -> docPage[ '£ileno']. "</span>"; 

echo "< span class = 'format > 拟稿 人 :". 

$ this - »docPage[ 'editname']. "</span>"; 
echo "< span class = 'format > 发 布 人 :". 
$ this - »docPage[ 'checknane']. "</span>" ; 

?> 
<hr /> 


请 大 家 注意 代码 中 的 阴影 部 分 ,这 些 都 是 通过 联合 查询 从 表 tb_user 和 表 tb_depar 中 


得 到 的 。 代 码 添加 完毕 后 ,打开 系统 主页 , 单 击 “ 通 知 公告 "展示 区 的 通知 标题 ,页 面 效 果 如 
图 8.9 所 示 。 
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8.9 公文 信息 的 详细 显示 


8.3.4 全 部 公文 信息 的 列表 显示 


在 系统 主页 中 只 显示 了 最 新 发 布 的 部 分 公文 信息 ,下 面 实现 在 Document 控制 器 中 显 
示 所 有 公文 信息 的 功能 ,以 方便 用 户 查 询 。 

1. 页 面 效 果 

一 般 全 部 信息 的 列表 显示 都 配 有 相应 的 排序 与 条 件 查询 功能 ,就 像 我 们 在 第 7 章 中 所 
做 的 那样 。 这 里 为 了 简便 ,省 略 了 查询 部 分 ,在 显示 全 部 信息 的 时 候 固定 地 进行 了 公文 的 排 
序 与 分 类 ,如 图 8. 10 所 示 。 

图 8. 10 所 示 的 信息 显示 页 面 分 为 上 、 下 两 个 功能 区 ,上 区 是 操作 功能 区 ,这 里 会 根据 用 


户 的 权限 显示 不 同 的 功能 按钮 ; 下 区 为 公文 列表 显示 区 ,这 里 显示 公文 的 编号 标题 ,发 布 
部 门 及 发 布 日 期 等 信息 ,并 配 有 分 页 控制 条 ,对 页 面 进行 控制 。 
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图 8.10 公文 信息 管理 主页 


2. 创建 控制 器 方法 
打开 Zend Studio 集成 开发 环境 的 ZF Tool 命令 窗口 ,输入 命令 : 


zf create action list Document 
在 控制 器 Document 中 创建 list 方法 ,并 添加 如 下 代码 : 


public function listAction() 
( 
// 获 取 页 面 参 数 
$ page= $ this -> getRequest() - > getParam( 'page') ; 
$1t- $this-»getRequest() - > getParan( '1t'); 
// 每 页 显示 记录 数 
$ pageSize = 7; 
// 查 询 结果 分 页 
$ paginatorl- $ this->_page -> getPages( $ 1t,1, $ page, $ pageSize) ; 
$ paginator2 = $ this->_page -> getPages( $ lt, 2, $ page, $ pageSize) ; 
$ paginator3 = $ this- » page -> getPages( $ lt,5, $ page, $ pageSize); 
$ paginator4 = $ this->_page -> getPages( $ lt,8, $ page, $ pageSize) ; 
$ paginator5 = $ this- » page -> getPages( $ 1t, 15, $ page, $ pageSize); 
$ paginator = array( $ paginatorl, $ paginator2, $ paginator3, 
$ paginator4, $ paginator5); 
// 传 递 页 面 参数 
$this—->view ->1t= $1t; 
$ this -> view 一 > paginator = $ paginator; 


) 
这 里 根据 公文 的 类 别 对 信息 进行 了 简单 的 分 类 ,实际 开发 时 ,请 大 家 根据 项 目 要 求 进行 


AUG BE ERA 


d oo w 


PHP Zend Framework 5t A FEŻ 2 RUHE 


具体 设计 。 该 代码 中 使 用 了 Page 模型 的 getPages 方法 来 获取 查询 到 的 分 页 数据 。 

在 图 8. 10 给 出 的 效果 中 显示 了 公文 信息 的 “发 布 部 门 ”, 所 以 模型 方法 中 也 需要 采用 数 
据 库 联合 查询 的 方式 从 tb. depart 表 中 提取 “发 布 部 门 ”* 的 名 称 。 

3. 修改 模型 方法 

打开 application\models\Page. php 模型 文件 ,修改 如 下 阴影 位 置 的 代码 : 


public function getPages ( $ orderIndex, $ where = null, $ page = 1, $ itemCountPerPage = 10, 
$ pageRange = 5) 
{ 
// 生 成 select 对 象 
$ select = $ this -> select() -> setIntegrityCheck(false); 
$ select -> from( $ this- » name); 
$ select -> where( tb docs.typeid- ?', $ where); 
// 排 序 方式 
if ( $ orderIndex == O) ( 
$ order = 'tb docs.createtime desc'; 
} elseif ( $ orderIndex-- 1) ( 
$ order = 'tb_docs. createtime'; 
) 
$ select -> order( 'tb docs. urgency') ; 
$ select -> order( $ order); 
$ select -> join('tb depart', 
'tb docs.fromdepart = tb depart. id', 'name as fromname'); 


return $ paginator; 


) 


4. 修改 视图 文件 
打开 application\views\scripts\document\docdetail. phtml 视图 文件 ,删除 原 有 全 部 内 
容 , 添 加 如 下 代码 : 


<br /><br /> 
< style> 
<! -- 


--> 
</style> 
<?php $ typeid = 2?> 
< div class = "operBox"> 
<ul class = "operNav"> 
<li><a href - " # ">< ing alt = "" src = "/images/queryBtn. jpg"></a></1i> 
<li><a href = "/document/list"> 


< img alt = "" src = "/images/refreshBtn. jpg"></a></li> 
</ul> 
</div> 
<div class = "file> R PEALIK, UREA AR AERE RE 
<hr /> 


< div class = "tabbox"> 
< div class = "menu3"> 
<ul> 


<li id = "threel" onmouseover = "setTablist('three',1,5)" 
class = "hover"> 会 议 通知 </1i> 
<li id = "three2" onmouseover = "setTablist( 'three',2,5)"» 


公示 公告 </1i> 
<li id= "three3" onmouseover = "setTablist('three',3,5)"> 
启事 通报 </1i> 
<li id= "three4" onmouseover = "setTablist('three',4,5)"> 
信息 发 布 </1i> 
<li id= "three5" onmouseover = "setTablist('three',5,5)" > 
工作 安排 </1i> 
</ul> 
< div class = "clear"></div> 
</div> 


<div class = "con t" id="con_three_1" > 
< table class = "list"> 
«tr» 
«th width= "15 $ "> 文件 编号 </th> 
«th width = "45 $ "> 标题 </th> 
«th width= "30g% "> 发 布 单位 </th> 
«th width= "10g% "> 发 布 日 期 </th> 
</tr> 
«?php foreach ( $ this -> paginator[0] as $key=> $ page) :?> 
«tr»«td»«?php echo $ page[ '£ileno'] ?></td> 
<td><?php echo $ page[ 'title']?»«/td- 
<td><?php echo $ page[ '£romname']?» «/td 
<td><?php echo date( 'Y — m- d', $ page[ 'createtime'])?»«/td» 
</tr> 
<?php endforeach;?> 
</table> 
< div class = "clear"></div> 
</div> 


< div class = "nav1" id= "nav three 1" style = "display:block"> 
<?php echo $ this -> paginationControl( 
$ this - > paginator[0], 'Sliding', 
'partials/list page pagination control.phtml', 
array('lt' => $ this-» 1t))?» 
</div> 


</div> 


视图 用 JavaScript 实现 了 选项 卡 形式 的 页 面 形式 ,在 项 目的 public\js 文件 夹 中 有 相应 
的 源 代 码 ,请 大 家 查阅 。 

在 上 述 代 码 中 ,中 间 的 阴影 部 分 为 数据 的 输出 ; 末尾 的 阴影 部 分 为 分 页 控制 条 泻 染 代 
码 。 这 两 部 分 都 只 列 出 了 一 个 小 节 的 内 容 , 省 略 的 代码 与 此 相同 。 


8.4 ”部 门 公文 信息 管理 


8. 3 节 中 实现 的 是 对 全 部 公文 信息 的 显示 ,没有 涉及 部 门 与 个 人 。 其 实在 实际 工作 过 
程 中 ,人 们 最 关心 的 是 与 自己 有 关 的 公文 信息 。 本 节 实 现 个 人 公文 信息 的 管理 ,包括 全 部 公 
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文 、 待 办 公文 .在 办 公文 和 办 结 公文 等 。 
8.4.1 部 门 公文 信息 管理 流程 


部 门 公文 信息 管理 是 由 各 部 门 指 定 的 部 门 管理 员 完 成 的 ,该 管理 员 具 有 比 普 通用 户 高 
的 管理 权限 ,可 以 签收 发 布 文件 。 

发 给 本 部 门 的 所 有 信息 首先 存放 在 “ 待 办 公文 ” 表 中 ,部 门 公文 信息 管理 员 查 看 确认 后 
签收 文件 ,即将 文件 转 入 “在 办 公文 " 表 ; 在 “在 办 公文 " 表 中 显示 该 文件 办 理 的 截止 日 期 , 提 
醒 管理 员 合理 安排 工作 时 间 ; 公文 处 理 完毕 ,并 得 到 本 部 门 领 导 或 发 文部 门 认可 后 ,就 可 以 
将 该 文件 由 “在 办 公文 " 表 转 入 “办 结 公 文 " 表 中 。 

在 表 8. 1 所 示 的 字段 描述 中 ,数据 表 tb_docs 中 设置 的 3 个 字段 (tododepart、 
doingdepart 和 donedepart) 分 别 用 来 记录 上 述 公文 状态 的 变化 。 例 如 序号 为 “1? 的 公文 发 
给 了 “计算 机 学 院 ”, 当 计算 机 学 院 的 管理 员 查 询 公 文 时 ,就 会 在 “ 待 办 公文 " 表 中 发 现 它 , 管 
理 员 确认 签收 后 ,就 会 在 tb. docs 表 的 doingdepart 字段 中 存 和 计算 机 学 院 的 序号 (tb_ 
depart 表 中 计算 机 学 院 的 id 值 ,假设 为 6) ,此 时 tb. docs 表 的 tododepart 字段 中 的 “6? 被 删 
除 ; 公文 处 理 完毕 ,管理 员 将 该 文件 移 和 人 “办 结 公文 "中 , 即 执行 tb_docs 表 的 doingdepart F 
段 中 的 “6” 的 删除 、 在 donedepart 字段 中 添加 “6” 的 操作 。 这 样 ,通过 搜索 这 3 个 字段 中 的 
关键 字 就 可 以 知道 该 文件 在 各 个 签收 部 门 的 状态 。 

如 图 8. 11 所 示 表 示 发 给 “计算 机 学 院 ”" 的 全 部 公文 ,包括 待 办 公文 、 在 办 公文 .已 办 


这 里 是 个 人 公文 列表 ,分 为 待 办 、 在 办 、 办 结 、 发 布 等 分 类 


待 办 公文 在 办 公文 办 结 公文 发 布 公文 
| “文件 编号 #5 发 布 单位 发 布 日 其 
| 计 科 2014080321 — 计算 机 科学 与 技术 学 了 学生 优 秀 作品 展示 计 工 机 学 院 2014-08-03 
(Sono EARLS AA EE | 20140603 
| 计 科 2014080223 — XTWOORERERUBRVUVT 计算 机 学 院 2014.08.03 
计 科 2014080223 AFRICE RHETRHURENNBUR 计算 机 学 院 2014-08-02 
| 教 2014073101 数据 结构 教学 教务 处 2014-06-19 
| 教 2014073101 — WEÉTfFE 教务 处 2014.06.03 
| 人事 2014073101 。 微 信 平 台 讲座 人 事 处 2014-05-29 


BEDAE BIRAR HB? »55k 


图 8.11 部 门 全 部 公文 信息 页 面 


如 图 8. 12 所 示 表 示 发 给 “计算 机 学 院 " 的 所 有 待 处 理 的 公文 ,界面 中 的 操作 为 签收” 
链接 。 


这 里 是 个 人 公文 列表 ,分 为 待 办 、 在 办 、 办 结 、 发 布 等 分 类 


在 办 公文 办 结 公文 发 布 公文 全 部 公文 

文件 编号 标 是 发 布 单位 发 布 日 期  #fF 
| 招 办 2014080102 — 2014 年 迎新 工作 会 议 | 学 校 办 公 室 1970-01-01 | 
| 招 办 2014080103 — 迎新 工作 会 议 学 校 办 公 室 (19000101 
| 科 产 2014080501 。 | 中科院 二 学术 潮 褒 通知 FEME 19700101 
355201410100 “国家 级 精品 课程 研讨 学 校 办 公 室 1970-01-01 
教 2014120102 。 《面向 对 象 程序 设计 教程 (C++ 语言 所 壕 )》 第 二 版 出 版 教务 处 loo | 
教 20141203 课堂 交流 ast 20140528 | 
| 人 事 2014073101 — 微 信 平 台 讲座 人 事 处 [240529 | 


Gum m mee o “| 国王 | 


图 8.12 部 门 待 办 公文 信息 页 面 


8.4.2 部 门 公文 接收 的 实现 


1. 添加 模型 方法 

接收 部 门 公文 信息 就 是 以 该 部 门 名 称 为 关键 字 , 在 数据 库 中 进行 查询 。 所 以 ,需要 在 
Page 模型 中 添加 方法 ,以 关键 字 为 参数 实现 数据 库 的 查询 。 

打开 模型 文件 application\models\ Page. php, 添 加 如 下 代码 : 


public function getByLike ( $ field, $ department, $ page = 1, $ itemCountPerPage = 8, $ pageRange = 5) 
( 
$ select = $ this -> select() -> setIntegrityCheck(false); 
$ select -> from( $ this- ^ name); 
$ select -> where( $ this -» name. '. '. $ field. ' like ?','% '. $ department . '% '); 
$ order = 'tb_docs. createtime'; 
$ select -> order( $ order); 
$ select -> join('tb depart', 'tb_docs. fromdepart = tb depart. id', name as fromname'); 
$ result = $ this - » fetchAll( $ select); 
if ( $ result != null) { 
$ result = $ result -» toArray(); 
) 
// 实 例 Zend Paginator 对 象 
$ paginatorAdapter = new Zend Paginator Adapter Array( $ result); 
$ paginator - new Zend Paginator( $ paginatorAdapter); 
$ paginator 一 > setPageRange( $ pageRange) - > setItemCountPerPage( 
$ itemCountPerPage) -> setCurrentPageNumber( $ page); 
return $ paginator; 


) 
这 里 采用 了 模糊 查询 的 方法 ,并 且 可 以 针对 不 同 的 字段 进行 查询 。 代 码 中 的 分 页 适 配 


doom 


ATE E EB 
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器 用 的 是 Array 适配器 ,请 大 家 注意 。 
2. 添加 控制 器 方法 
打开 Zend Studio 集成 开发 环境 的 ZF Tool 工具 窗口 ,输入 命令 : 


zf create action receive Document 


在 Document 控制 器 中 添加 receive 方法 ,这 也 是 导航 菜单 项 “公文 管理 ?|* 收 文 管理 ” 
的 链接 。 编 写 代 码 : 


public function receiveAction() 
{ 
// 获 取 页 面 参 数 
$ page= $ this - > getRequest() - > getParan( 'page') ; 
$1t- $this- »getRequest() -> getParan( '1t'); 
// 每 页 显示 记录 数 
$ pageSize = 7; 
// 待 办 公文 
$ field= 'tododepart '; 
$ depart = $ this-» user-» getIdentity() -> depart id; 
$ paginatorl- $ this- » page -> getByLike( 
$ field, $ depart, $ page, $ pageSize) ; 


$ paginator = array( $ paginatorl, $ paginator2, $ paginator3, 
$ paginator4, $ paginator5); 
// 传 递 页 面 参数 
$this-»view-»1lt- $1t; 
$ this -> view- > paginator = $ paginator; 
} 
代码 中 省 略 的 部 分 为 “在 办 公文 “办 结 公 文 " 代 码 ,与 “ 待 办 公文 ?的 相似 ,只 是 查询 的 
字段 不 同 而 已 。 
3. 修改 视图 文件 
Document 控制 器 的 receive 方法 对 应 的 视图 文件 为 application \ views V scripts V 
document\receive. phtml。 它 与 list 方法 的 视图 基本 相同 ,但 要 注意 的 是 ,分 页 控制 条 视图 
文件 要 重新 复制 一 份 ,因为 翻 页 链接 这 里 对 应 的 是 receive 方法 。 


8.5 公文 文档 的 创建 与 发 布 


公文 信息 可 以 供 所 有 用 户 浏 览 ,但 公文 的 发 布 需要 相应 的 权限 。 关 于 用 户 权 限 ,将 在 后 
面 的 第 12 章 中 详细 介绍 。 公 文 的 发 布 一 般 分 为 3 个 步骤 ,首先 由 拟稿 人 编辑 公文 文档 , 然 
后 提交 校 核 人 校对 ,最 后 由 领导 批准 发 布 。 


8.5.1 公文 信息 表单 
打开 Zend Studio 集成 开发 环境 的 ZF Tool 工具 窗口 ,输入 命令 : 


zf create form File 


创建 File 表单 文件 , 它 位 于 applicationMorms 目录 下 ,然后 打开 该 文件 ,并 在 表单 类 
Wm. Form File 的 init 初始 化 方法 中 添加 代码 : 


class Wm Form File extends Zend Form 


{ 
public function init() 
{ 
$ this - > setName( 'form file') // 表 单 名 称 
一 > setMethod( 'post') // 表 单 提交 方法 
—>addAttribs(array( 
'style' => 'margin:l0px' // 表 单 样式 
)); 
// 文 件 编号 


$ fileNo = $ this -> createElement( 'text', 'fileno'); 
$ fileNo- » setLabel(' 文 件 编号 : '); 
$ £ileNo- » setRequired(TRUE); 
$ fileNo -> setOptions(array('readonly' => true)); 
$ this - > addElement( $ fileNo); 
// 文 件 标题 
$ title= $ this -> createElement('text'，'title') 7 
$ title -> setLabel( "文件 标题 : '); 
$ title -> setRequired(TRUE) ; 
$ title -> setOptions(array( 'style' = »'width:400px')); 
$ title -> addValidator( 'stringLength', false, array(4, 100) ); 
$ title -> addErrorMessage( ' 标 题 应 有 2 - 50 个 汉字 . '); 
$ this - » addElement( $ title); 
// 文 件 类 型 
$ doctype = $ this - > createElement( 'select', 'typeid'); 
$ doctype -> setLabel( ' 文 件 类 型 : "); 
$ doctype - > setRequired(TRUE); 
$ modelType = new Wm Model Ftype(); 
$ ftypes = $ modelType - > getFtypes(); 
if ( $ ftypes != null ){ 
foreach( $ ftypes as $ value)( 
$ doctype - > addMultiOption( $ value -> id, $ value - > name) ; 
) 
) 
$ this - > addElenent( $ doctype); 
// 发 文部 门 
$ fromdepart = $ this -> createElement( 'text', 'fromdepartl'); 
$ fromdepart -> setLabel( AZ X BEI]: '); 
$ frondepart - » setOptions(array( readonly' => true)); 
$ this -> addElement( $ fromdepart); 
// 拟 稿 人 
$ eidt- $ this -> createElement( text', 'edit'); 
$ eidt -> setLabel( ' 拟 稿 人 : 7); 
$ eidt -> setOptions(array('readonly'-» true)); 
$ this - » addElement( $ eidt); 
// 收 文部 门 
$ depart = $ this - > createElement( 'select', 'tododepart1 '); 
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$ depart - > setLabel( ' 收 文部 门 : '); 
$ depart — > setRequired(TRUE); 
$ depart - » setOptions(array('onChange' = »'setDepart() ')); 
$ modelDeparts = new Wm Model Depart(); 
$ departs = $ modelDeparts — > getDeparts(); 
if ( $ departs != null ){ 

foreach( $ departs as $ value){ 

$ depart -> addMultiOption( $ value -> id, $ value - > name) ; 


} 
$ this -> addElenent( $ depart); 


// 收 文部 门 
$ todepart = $ this -> createElement( 'text', 'tododepart'); 
$ todepart -> setLabel(''); 
$ todepart - > setOptions(array( 'readonly' => true, 'id' = »'todepart', 'style' = »'width: 
400px')); 
$ this -> addElement( $ todepart); 
// 文 件 内 容 
$ body= $ this -> createElement( textarea', 'body'); 
$ body - > setLabel( "文件 内 容 : "); 
$ body - > setAttribs(array('rows'-» 10, 'cols' 72» 75)); 
$ body - > setRequired(TRUE); 
$ this - » addElement( $ body) ; 
// 关 键 词 
$ tags $ this -> createElement( text', 'keyword'); 
$ tags - » setLabel( ' 关 键 词 : '); 
$ this - > addElement( $ tags); 
// 附 件 
$attach- $ this -> createElement( 'file', 'attach'); 
$ attach - » setLabel('Bfiff: '); 
$ attach - > setRequired(false); 
$ this - » addElenent( $ attach); 
// 发 布 状态 
$ status = $ this - > createElement( 'checkbox', 'status'); 
$ status -> setLabel(' 是 否 直接 发 布 : n); 
$ status 一 > setValue(0); 
$ this - > addElement( $ status); 
// 是 否 可 以 反馈 
$allow= $ this—>createElement('checkbox', 'suggest'); 
$ allow-» setLabel(' 人 允许 反馈 : '); 
$ allow—> setValue(0); 
$ this 一 > addElement( $ allow); 
// 提 交 按 钮 
$ submit = $ this- > createElement('subnit', ' 提 交 '); 
$ this -> addElement( $ submit); 
// 表 单 装饰 器 
$ this 一 > setElementDecorators(array( 
"ViewHelper', 
'Errors', 
array(array('data' = »'HtnlTag'),array( 'tag' =>'td')), 


array( Label',array('tag'-»'th')), 

array(array( 'row' = »'HtmlTag'),array( tag' - »'tr')), 

); 

$ this -> getElement('attach') - > setDecorators( 
array( 

"File', 
array(array('data'-» 'HtmlTag'),array('tag' 7» 'td')), 
array('Label',array('tag'-» 'th')), 
array(array('row'-» 'HtmlTag'),array('tag'-» 'tr')) 


) 

$ this - » setDecorators(array( 

'FormElements', 

array( 'HtnlTag', array( 'tag' = »'table', 'class' = »'sheet')), 'Forn' 
); 


) 
表单 页 面 效果 如 图 8. 13 所 示 。 
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图 8.13 公文 信息 录入 表单 


doo 3 


PHP Zend Framework 5t A FEŻ 2 RUHE 


8.5.2 公文 表单 处 理 方 法 


公文 表单 提交 后 ,由 Document 控制 器 的 issue 方法 进行 处 理 。 
打开 Zend Studio 集成 开发 环境 的 ZF Tool 工具 窗口 ,输入 命令 : 


zf create action issue Document 


在 Document 控制 器 中 创建 issue 方法 ,打开 控制 器 文件 ,编写 如 下 代码 : 


public function issueAction() 
{ 
$ formFile = new Wm_Form_File(); 
$ modelDepart = new Wm Model Depart(); 
$ depart id- $ this-» user-» getldentity() -> depart id; 
$ fromDepart = $ modelDepart — > getDepart( $ depart id); 
// 生 成 文件 编号 
$file prefix- $ fromDepart -> file prefix; 
$ fileno- $ file prefix. date( 'YndH') ; 
$ formFile -> getElement( 'fileno') -> setValue( $ fileno); 
// 发 文部 门 
$ departName = $ fromDepart - » name; 
$ fornFile-  getElement( 'fromdepart1') -> setValue( $ departName); 
// 拟 稿 人 
$ edit= $ this ->_user 一 > getIdentity() -> username; 
$ uid= $ this-» user -> getIdentity() -> id; 
$ formFile -> getElement('edit') —» setValue( $ edit); 
if( $ this -> getRequest() -> isPost())( 
if( $ formFile—> isValid( $ POST))( 
$ data= $ fornFile- »getValues(); 
// 移 除 不 需要 的 表单 元 素 
unset( $ data[ '£rondepart1']); 
unset( $ data[ 'tododepart1']); 
unset( $ data[ 'edit']); 
unset( $ data[ 'attach']) ; 
// 设 置 其 他 字段 值 
$ data[ 'uid'] = $ uid; 
$ data[ 'checkid'] $ uid; 
$ data[ 'fromdepart']- $ depart id; 
$ data[ 'createtime'] = time(); 
// 完 成 公文 的 添加 
$this 一 >_page 一 >addPage( $ data); 
) 
) 
$ this -> view-» formFile- $ formFile; 
) 


这 里 ,公文 的 文件 编号 ,发 文部 门 、 拟 稿 人 3 项 内 容 由 程序 自动 设置 。 文 件 编号 由 发 文 
部 门 的 “文件 前 缀 ?加 上 * 日 期 的 年 月 日 小 时 ?组 成 ,发 文部 门 的 文件 前 组 从 数据 库 的 tb_ 
depart 表 中 获取 ;“ 发 文部 门 ”与 “拟稿 人 ”直接 设置 为 登录 用 户 的 相关 信息 ,也 就 是 说 ,公文 
的 拟稿 人 就 是 已 通过 认证 的 登录 用 户 本 人 。 


8.5.3 公文 信息 处 理 模 型 方法 


在 上 述 控制 器 方法 代码 中 使 用 模型 方法 addPage 执行 公文 信息 的 添加 ,下 面 编写 该 方 
法 的 代码 。 
打开 模型 文件 application\models\Page. php ,添加 如 下 代码 : 


public function addPage( $ data = array()) 


{ 
$ row- $ this - » createRow() ; 
if (count( $ data) > 0){ 
foreach ( $ data as $ key -» $ value)( 
$ row->$ key= $ value; 
} 
$ row - > save(); 
return $ row 一 > id; 
} 
else{ 
throw new Zend_Exception( ' 向 数据 库 中 写 和 人 数据 失败 ! ) ; 
) 
] 


这 段 代 码 比较 简单 ,首先 使 用 Zend Db Table Abstract 类 的 createRow 方法 创建 一 个 
Zend Db, Table Row. Abstract 类 的 实例 row ,然后 通过 Zend_Db_Table_Row_Abstract 类 
的 save 方法 将 数据 写 入 数据 库 中 。 


8.5.4 添加 视图 


上 面 创建 的 表单 ,在 issue 控制 器 方法 中 实例 化 后 要 在 视图 中 演 染 出 来 。 打 开 视 图 文 
件 application\views\scripts\document\issue. phtml ,删除 原 有 全 部 内 容 ,添加 如 下 代码 : 


<br /><br /> 
< div class = "operBox"> 
<ul class = "operNav"> 
<li><a href = "/docunent/issue"» 
< img alt = "" src = "/images/addBtn. jpg"></a></li> 
<li><a href 2 " # ">< ing alt = "" src = "/images/queryBtn. jpg"></a></1i> 
<li><a href =" # ">< img alt = "" src = "/images/deleteBtn. jpg"></a></li > 
<li><a href = "/document/ issue "> 
< img alt = "" src = "/images/refreshBtn. jpg"></a></1i> 
<li><a href =" # ">< ing alt = "" src = "/images/editBtn. jpg"></a></1i> 
</ul> 
</div> 
<div class = "file" ><?php echo $ this- > formFile?></div> 
< script type = "text/javascript" > 
function setDepart()( 
var departl = document. getElementById( 'todepart'); 
var depart2 = document. getElementById( 'tododepartl'); 
depart1. value = depart1. value + depart2. options[depart2.selectedIndex].text + ","; 
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</script> 


请 大 家 注意 上 述 代码 的 阴影 部 分 ,第 1 行 是 对 公文 信息 表单 的 泻 染 , 下 面 是 一 段 
JavaScript 代码 。 

为 什么 要 编写 这 样 一 个 JavaScript 函数 呢 ? 从 图 8. 13 给 出 的 表单 效果 可 以 看 出 ,“ 收 
文部 门 ”文本 框 中 记录 的 接收 部 门 是 由 其 上 面 的 select 选择 表单 元 素 提 供 的 ,拟稿 人 通过 选 
择 确 定 公 文 送 达 的 部 门 。 拟 稿 人 的 选择 要 及 时 地 在 “收文 部 门 ” 文 本 框 中 显示 出 来 ,这 段 
JavaScript 代码 就 是 用 来 完成 这 个 功能 的 。 其 中 的 表单 元 素 id 和 选择 表单 元 素 的 onChange() 
属性 都 是 在 表单 对 象 中 设置 的 。 


8.6 公文 附件 的 上 传 


在 8.4 节 中 ,在 创建 公文 文档 的 时 候 采 用 的 是 简单 的 文本 编辑 框 , 所 有 的 内 容 都 是 由 键 
盘 输入 的 。 在 输入 过 程 中 ,文档 的 格式 还 要 通过 添加 一 些 HTML 标签 进行 控制 ,这 在 实际 
使 用 中 显然 是 不 行 的 。 为 了 弥补 在 线 编辑 的 不 足 ,很 多 公文 往往 是 以 附件 的 形式 传送 的 ,这 
也 有 利于 用 户 的 阅读 与 收藏 。 另 外 要 说 明 的 是 ,在 实际 项 目 开 发 过 程 中 会 充分 利用 现 有 的 
一 些 框架 技术 来 增加 系统 的 功能 ,例如 Zend Framework 支持 良好 的 Dojo, 还 有 大 家 非常 熟 
悉 的 jQuery 等 。 由 于 本 书 主要 介绍 Zend Framework 技术 ,所 以 没有 用 到 这 些 框架 ,以 使 
问题 尽量 简单 化 。 

在 Zend Framework 项 目的 开发 过 程 中 ,通常 采用 两 种 方法 完成 文件 的 上 传 操作 : 一 种 
是 采用 Zend. File 组 件 ,就 像 第 7 章 中 实现 用 户 信 息 的 批量 注入 时 那样 ; 另 一 种 就 是 直接 采 
用 Zend. Form 的 文件 表单 元 素来 完成 文件 的 上 传 操作 ,下 面 分 别 进行 介绍 。 


8.6.1 文件 上 传 的 表单 方法 


在 第 6 章 中 介绍 了 Zend Form 的 标准 表单 元 素 ,并 给 出 了 它们 对 应 的 类 。 文 件 上 传 表 
单元 素 不 在 其 标准 表单 元 素 之 列 , 它 所 对 应 的 类 为 Zend_Form_Element_File, 可 以 通过 该 
类 创建 文件 上 传 表单 元 素 。 在 图 8. 13 所 示 的 表单 中 ,文件 上 传 表单 元 素 是 通过 Zend | 
Form 的 createElement 方法 创建 的 。 

打开 Document 控制 器 文件 ,在 issue 方法 中 添加 代码 : 


public function issueAction() 


{ 


if( $ this -> getRequest() -> isPost())( 
if( $ formFile 一 > isValid( $ POST))( 
// 附 件 上 传 
$ path = APPLICATION PATE. '/../public/uploads/'. 
date('Y -m- d'). '/fileattach/'; 
$ folder = new Zend Search Lucene Storage Directory Filesystem( $ path); 
$ formattach- $ formFile - > getElement('attach'); 
$ formattach- » setDestination( $ path); 
$ fileinfo- pathinfo( $ formattach- » getFileName()); 
$ extName = $ fileinfo[ extension']; 


$ filename = 'attach'. $ this 一 >_user 一 > getIdentity() -> 


$ formattach— > addFilter( Rename', 


id. time().'.'. $ extName; 


array( 'target' => $ filename, 'overwrite' => true) ); 


if( $ formattach 一 > receive()){ 


$ newinfo = pathinfo( $ formattach 一 > getFileName()); 
$ file= date('Y- m- d'). /fileattach/ 
. $ neuinfo[ 'basename'] ; 


}else ( 


throw new Zend Exception( ' 文 件 附 件 上 传 失败 ! '); 


exit(); 
} 
$ data= $ formFile -> getValues(); 


// 读 人 数据 准备 


$ data[ 'attach'] = $ file; 


$ newPage = $ this ->_page — > addPage( $ data); 
$ this -> redirect ( '/document/docdetail/id/'. $ newPage) ; 


} 
} 
$ this -> view- > formFile= $ formFile; 
) 


从 代码 中 的 变量 path 的 值 可 以 看 出 ,上 传 的 公文 附件 存放 在 系统 目录 下 的 public\ 


uploads\ date ( ' Y-m-d ') \ fileattach 文件 夹 中 ,其 中 的 
date('Y-m-d') 是 用 “年 -月 -日 "构造 的 动态 目录 名 ,其 效 
果 如 图 8. 14 所 示 。 

接着 分 析 上 述 代码 ,确定 了 文件 上 传 的 目录 后 , 接 
下 来 用 参数 path 实例 化 一 个 Zend_Search_Lucene_ 
Storage_Directory_Filesystem 类 对 象 。 这 个 类 实现 了 
针对 文件 系统 的 目录 功能 ,如 果 参 数 是 一 个 字符 串 , 则 
该 类 会 认为 这 个 字符 串 是 一 个 文件 系统 的 路 径 , 若 这 个 
路 径 不 存在 ,就 会 自动 创建 。 


4 (9 public 
» B css 
» (f images 
br Bj 
4 (9 uploads 
4 (95 2014-08-03 
4 (99 fileattach 


国 attach11407060220. 


B htaccess 
> 回 indexphp 
b $B tests 


图 8.14 公文 附件 的 存储 目录 结构 


代码 中 的 formattach 变量 就 是 文件 表单 中 的 “附件 上 传 ”表单 元 素 ,通过 它 调用 
setDestination 方法 设置 path 为 文件 上 传 的 目标 地 址 。 变 量 filename 为 上 传 文件 到 服务 器 
后 的 新 文件 名 ,这 里 是 用 attach 十 “用 户 的 id” 十 “当前 时 间 戳 ”十 “原文 件 扩展 名 ”来 构成 ,这 
样 可 以 根据 文件 名 确定 该 文件 的 类 型 、 上 传 的 时 间 与 上 传 操作 者 。 

该 代码 中 调用 addFilter 方法 设置 文件 上 传 过 滤器 ,主要 功能 是 用 新 文件 名 替代 原 有 文 
件 的 名 字 。 一 切 都 准备 好 后 .调用 Zend_Form_Element_File 类 的 receive 方法 执行 文件 上 
传 操 作 。 如 果 没 有 异常 ,记录 上 传 文件 的 目录 及 名 字 , 以 备 写 入 数据 库 。 

文件 成 功 上 传 后 ,还 需要 在 视图 文件 的 适当 位 置 输出 其 链接 。 打 开 Document 控制 器 
的 docdetail 视图 文件 application\views\scripts\document\docdetail. phtml, 添 加 代码 : 


<p><?php echo $ this -> docPage[ 'body'];?></p> 
<hr /> 
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<?php if( $ this -> docPage[ 'attach']) :?> 

< span > 附件 : &nbsp; &nbsp; &nbsp; &nbsp; < a href = "<?php echo '/uploads/'. $ this - > docPage 
['attach'];?>"> 单 击 这 里 查看 附件 </a></span> 

«hr /> 

<?php endif;?> 

<?php 


?> 
<hr /> 


公文 附件 上 传 成 功 并 单 击 链接 后 的 效果 如 图 8. 15 所 示 。 这 里 演示 的 是 基本 操作 ,在 实 
际 项 目 中 还 必须 对 上 传 文件 的 类 型 进行 验证 ,不 允许 用 户 上 传 exe, php 等 危险 文件 到 服务 器 。 


—ÍÓ————MÓáÜ—Á 


计算 机 科学 与 技术 学 院 学 生 优秀 作品 展示 


发 布 部 门 : 计算 机 学 院 发 布 时 间 : 2014-08-03 


您 想 打开 或 保存 此 文件 中? 


名 称 : attach11407071831.doc 
类 型 : Microsoft Word 文档 26.2KB 
来 源 : 


文件 编号 : 计 科 2014080321 


wmoams.com 


CARO 
Eaei eSa E BI 0) 


图 8.15 公文 上 传 附件 的 使 用 


8.6.2 文件 上 传 的 组 件 方 法 


文件 上 传 的 组 件 方法 与 上 面 介 绍 的 Zend Form 表单 方法 基本 相似 ,只 是 使 用 的 适配器 
不 同 而 已 。 下 面 的 代码 是 在 第 7 章 的 用 户 信息 后 台 管 理 中 使 用 过 的 ,实现 用 户 信息 的 批量 
注入 。 这 里 采用 的 是 Zend File Transfer Adapter Http 文件 上 传 适 配器 。 


public function insertAction() 
{ 


if ( $ this -> getRequest() 一 > isPost ( ) ) { 
$ adapter = new Zend File Transfer Adapter Http(); 
$ path = APPLICATION PATH. '/resources/' 
.date( 'Y- m- d'). '/userInformation/'; 
$ folder = new Zend Search Lucene Storage Directory Filesystem( $ path); 
$ fileInfo- $ adapter - » getFileInfo(); 


$ extName = 'csv'; 
$ filename = 'admin'. $ this ->_user 一 > getIdentity() -> 
id.time(). '. '. $ extName; 
$ adapter - > addFilter( 'Rename', array( 
'target' => $ filename, 'overwrite' => true) ); 
$ adapter -> setDestination( $ path); 
$ adapter - > addValidator( 'Extension', false, array('csv')); 
if( $ adapter - » receive())( 
$ file= $ path. $ filename; 


}else{ 
throw new Zend _Exception( ' 文 件 上 传 失败 ! '); 
exit(); 

} 


$ modeUser = new Admin Model User(); 
if (( $ handle- fopen( $ file, r')) !== FALSE) ( 
$ columns = fgetcsv( $ handle, 1000, ","); 
) 
while (( $ data = fgetcsv( $ handle, 1000, ",")) !== FALSE) ( 
$ info- array combine( $ columns, $ data); 
$ addLastid- $ modeUser - > addByInfo( $ info); 
$ addNume* ; 
} 
fclose( $ handle); 


8.7 本 章 小 结 


本 章 主要 介绍 系统 公文 信息 管理 功能 的 实现 ,包括 数据 库 设 计 与 业务 逻辑 两 大 部 分 。 
通过 前 面 几 章 的 学 习 , 我 们 对 Zend Framework 框架 的 全 貌 已 经 有 了 比较 清晰 的 了 解 ,从 本 
章 开始 ,把 重点 转移 到 Zend Framework 的 组 件 技术 上 , 即 关 注 如 何 使 用 框架 提供 的 组 件 高 
Ak ,快捷 地 实现 应 用 的 业务 逻辑 。 

本 章 介 绍 的 Zend Framework 新 组 件 主要 是 Zend_Paginator 与 Zend_File, 它 们 分 别 完 
成 数据 的 分 页 控制 以 及 文件 的 上 传 与 下 载 功能 。 这 些 都 是 Web 应 用 中 的 常用 技术 ,希望 大 
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应 用 系统 的 内 部 留言 , 即 个 人 消息 的 发 送 与 接收 ,也 是 办 公 自 动 化 管理 系统 中 不 可 或 缺 
的 功能 之 一 。 它 不 同 于 QQ 等 即时 通信 工具 ,也 不 同 于 常用 的 邮件 发 送 系统 。 使 用 即时 通 
信 工 具 时 ,要 求 连接 外 部 网 络 ,并 且 通 信 双 方 必须 同时 在 线 ; 使 用 邮件 系统 时 ,不 仅 要求 连 
接 外 网 ,同时 还 需要 用 户 具有 确定 的 邮件 接收 地 址 。 内 部 留言 系统 是 应 用 系统 内 部 用 户 之 
间 短 暂 交 流 与 沟通 的 平台 , 它 其 实 不 针对 具体 的 用 户 , 只 是 将 全 部 信息 保存 于 系统 数据 库 中 
供用 户 查 询 而 已 。 

本 童 仿照 常用 的 Web 邮件 系统 的 外 观 实现 系统 的 内 部 留言 功能 ,由 此 介绍 Web 应 用 
中 的 社区 或 论坛 开发 的 业务 逻辑 。 


9.1 留言 功能 预览 


本 系统 的 留言 功能 仿照 常用 的 Web 邮件 系统 实现 ,主要 有 个 人 消息 的 接收 、 管 理 与 发 
送 。 其 中 ,消息 管理 设置 了 收 件 箱 ,草稿 箱 ,发 件 箱 与 垃圾 箱 功能 ,以 便 用 户 对 个 人 消息 进行 
分 类 管理 。 下 面 先 来 预览 一 下 留言 功能 实现 后 的 页 面 效果 。 

1. 系统 主页 个 人 消息 显示 效果 

用 户 通过 认证 进入 系统 主页 后 ,在 系统 主页 的 显示 区 有 一 个 名 为 “最 新 消息 ”的 版 块 ,这 

里 显示 的 是 用 户 个 人 最 新 消息 信息 ,如 图 9.1 9.1 所 示 。 
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图 9.1 系统 主页 最 新 消息 


2. 系统 留言 收 件 箱 显 示 效 果 
图 9. 2 所 示 为 用 户 个 人 消息 主页 面 效 果 , 同 时 也 是 系统 留言 收 件 箱 页 面 ,这 里 显示 用 户 
收 到 的 系统 留言 信息 ,主要 是 用 红色 图 标 标识 的 未 读 信息 。 
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图 9.2 用 户 消息 主页 页 面 
3. 系统 留言 发 件 箱 显 示 效 果 
图 9. 3 所 示 为 用 户 个 人 消息 发 件 箱 页 面 效 果 , 这 里 显示 用 户 已 发 出 的 留言 信息 。 
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图 9.3 用 户 信息 发 件 箱 页 面 
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4. 系统 留言 发 送 消息 页 面 效果 
图 9.4 所 示 为 用 户 个 人 消息 编辑 表单 页 面 效 果 ,表单 中 有 接收 消息 人 姓名 、 消 息 主题 以 
及 消息 详情 3 项 内 容 ,接收 信息 人 (好 友 ) 可 以 通过 列表 选取 。 
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图 9.4 用 户 信 息 发 送 页 面 


9.2 数据 库 设计 


为 了 实现 用 户 个 人 消息 的 发 送 与 分 类 显示 ,需要 按照 业务 处 理 流 程 设 计 相 应 的 数据 库 。 
本 系统 通过 “发 送 消 息 ”“ 接 收 消 息 ”" 和 “用 户 好 友 ”3 张 数据 表 配 合 模型 与 视图 来 实现 留言 
信息 管理 的 功能 。 

用 户 个 人 留言 消息 从 编辑 到 处 理 完毕 大 致 要 经 过 编辑 发送 ,接收 和 处 理 4 个 过 程 。 用 
户 在 如 图 9. 4 所 示 的 表单 中 编辑 好 消息 内 容 后 ,可 以 单 击 “ 保 存 到 草稿 箱 ” 按 钮 将 消息 进行 
保存 ,也 就 是 说 ,消息 暂 不 发 送 ; 也 可 以 单 击 “ 发 送 消息 "按钮 ,直接 将 消息 发 送出 去 。 这 个 
功能 通过 修改 “发 送 消息 ”数据 表 中 的 “消息 发 送 状 态 ” 字 有 段 值 来 完成 。 另 外 ,消息 的 阅读 与 
否 、 删 除 与 否 等 操作 也 都 可 以 采用 同样 的 方法 通过 修改 数据 表 中 的 相应 字段 值 来 实现 。 

1. 发 送 消息 数据 表 

打开 phpMyAdmin 数据 库 管理 工具 ,在 db_wmoams 数据 库 中 新 建 名 为 tb. send 的 数 
据 表 ,其 字段 含义 见 表 9. 11, 字段 属性 如 图 9. 5 所 示 。 


表 9.1 tb_send 数据 表 的 字段 说 明 


字 段 名 说 明 

id 自 增 变 量 , 主 键 ,消息 在 系统 中 的 唯一 标识 
sendto 消息 接收 人 

uid 消息 发 送 人 


title 消息 标题 


续 表 


字 段 名 说 H 
sendedflg 发 送 与 否 
delflg 删除 与 否 
contents 消息 内 容 
udat 更 新 时 间 
cdat 发 送 时 间 
BF am 排序 规则 属性 TOU S5 
id int(11) € X — AUTO INCREMENT 
sendto — varchar20) utfü general ci Ex 
uid varchar(20) utfü general ci zr 
tite varchar(400) utf& general ci ERE 
contents tex wtf8. general ci 是 NULL 
sendedfg int(1) 是 0 
delflg — ini) 是 0 
cdat datetime Ex 
udat datetime 是 NULL 
sdat datetime LEJ 


图 9.5 tb send 数据 表 的 属性 设置 


注意 : tb. send 数据 表 中 既 存 储 发 送信 息 也 存储 回复 信息 。 因 为 ,对 于 某 条 信息 的 回 
复 , 相 对 于 该 消息 的 接收 人 来 说 也 是 一 个 消息 发 送 的 过 程 。 

2. 接收 消息 数据 表 

使 用 phpMyAdmin 数据 库 管理 工具 在 db. wmoams 数据 库 中 新 建 名 为 tb. receive 的 数 
据 表 ,其 字段 含义 见 表 9.2, 字 段 属性 如 图 9.6 所 示 。 


表 9.2 tb receive 数据 表 字 的 段 说 明 


字 段 名 说 明 
id 自 增 变 量 ,主键 ,回复 消息 的 唯一 标识 
sid 回复 消息 在 tb_send 中 的 ID 
uid 消息 回复 人 
title 消息 标题 
delflg 删除 与 否 
readflg 阅读 与 否 
udat 更 新 时 间 
cdate 回复 时 间 


EF AM ”排序 规则 属性 空 默认 S 


id int(11) € 无 AUTO INCREMENT 
sid — in(M) 否 无 

delflg int(1) 是 0 

readflg int(1) 是 0 

udat datetime 是 NULL 

cdate datetime 是 NULL 


图 9.6 tb_receive 数据 表 的 属性 设置 


d o 中 
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3. 用 户 好 友 数 据 表 
使 用 phpMyAdmin 数据 库 管理 工具 在 db wmoams 数据 库 中 新 建 名 为 tb_friend 的 数 
据 表 ,其 字段 含义 见 表 9. 3 ,字段 属性 如 图 9.7 所 示 。 


表 9.3 tb friend 数据 表 的 字段 说 明 


字 段 名 说 明 
id 自 增 变量 ,主键 ,好 友 表 的 唯一 标识 
uid 用 户 ID 
friend 用 户 好 友 表 字符 串 
udat 更 新 时 间 
cdat 创建 时 间 


名 字 类 型 排序 规则 Et 空 RU SOR 


id — in(10) E Æ AUTO INCREMENT 
wid o in(4) 否 无 

friend varchar(20) utf8_general_ci 是 NULL 

cdat datetime 是 NULL 

udat datetime 是 NULL 


9.7 tb friend 数据 表 的 属性 设置 


注意 : tb. friend 数据 表 的 friend 字段 中 存储 的 是 由 用 户 所 有 好 友 姓 名 组 成 的 字符 串 ， 
在 使 用 时 需要 将 其 分 离 。 


9.3 消息 的 接收 


用 户 通过 选择 “个 人 办 公 ? 下 的 “个 人 消息 ?菜单 项 或 单 击 系统 主页 左 侧 的 快捷 菜单 “我 
的 办 公 桌 ”中 的 “个 人 消息 ”链接 都 可 以 进入 如 图 9. 2 所 示 的 用 户 消 息 接收 页 面 。 用 户 的 个 
人 消息 通过 列表 的 形式 在 这 里 显示 ,其 中 ,发 件 人 旁边 的 红色 信件 图 标 表 示 该 消息 还 未 阅 
读 ; 白色 图 标 则 表示 消息 已 阅读 。 


9.3.1 创建 控制 器 及 方法 


为 了 对 系统 留言 信息 进行 管理 , 需 设 置 相 应 的 控制 器 及 方法 。 控 制 器 及 方法 的 创建 还 
是 采用 Zend Framework 提供 的 工具 来 完成 。 

1. 创建 控制 器 

打开 Zend Studio 集成 开发 环境 ,通过 菜单 打开 ZF Tool 工具 窗口 ,输入 命令 : 


zf create controller Message 
创建 用 于 个 人 消息 管理 的 控制 器 Message. IIF Message 控制 器 文件 application V 
controllers\MessageController. php ,添加 一 些 初 始 化 代码 ,如 下 所 示 : 


class MessageController extends Zend Controller Action 
{ 


protected $ receiveMess = null; 


protected $ sendMess = null; 
protected $ user = null; 
protected $ friend- null; 
public function init() 
{ 
$ auth= Zend_Registry: :get( 'auth'); 
if( $ auth-> hasIdentity()){ 
$ this->_user = $ auth; 
} 
$ this ->_receiveMess = new Wn Model Receive(); 
$ this ->_sendMess = new Wn Model Send(); 
$this-» friend- new Wm Model Friend(); 


) 
public function indexAction() 
t 
$ this -> redirect( '/nessage/receive') ; 
) 


} 


其 中 ,对 象 user 是 已 通过 认证 的 登录 用 户 ; receiveMss sendMess 以 及 friend 分 别 为 
消息 接收 表 tb. receive H ERIAK tb_send 和 好 友 表 tb. friend 的 表 模 型 对 象 。 

2. 创建 控制 器 方法 

选择 Zend Studio 集成 开发 环境 工作 区 中 的 项 目 wmProject, 定 位 到 项 目的 任意 一 个 文 
件 夹 或 文件 。 打 开 ZF Tool 工具 窗口 ,分 别 输入 如 下 命令 ,给 Message 控制 器 添加 4 个 
方法 。 


zf create action receive Message 

zf create action send Message 

zf create action list Message 

zf create action friendlist Message 


9.3.2 创建 表 模 型 及 方法 


1. 创建 表 模型 
TE Zend Studio 集成 开发 环境 的 ZF Tool 工具 窗口 中 分 别 输入 如 下 命令 ,添加 9. 3. 1 节 
在 控制 器 初始 化 函数 中 用 到 的 3 个 表 模 型 。 


zf create model Receive 
zf create model Send 
zf create model Friend 


分 别 打开 3 个 模型 文件 ,为 其 设置 基 类 及 对 应 的 数据 表 名 称 , 代 码 如 下 : 


class Wm Model Receive extends Zend Db Table 
{ 
protected $ name- 'tb receive'; 


} 
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class Wm Model Send extends Zend Db Table 
{ 

protected $ name- 'tb send'; 
) 


class Wm Model Friend extends Zend Db Table 
{ 

protected $ name- 'tb friend'; 
} 


上 述 模型 类 的 基 类 也 可 以 使 用 Zend Db Table Abstract 类 ,这 个 类 其 实 也 是 Zend. Db | 
Table 类 的 基 类 。 

2. 添加 表 模 型 方法 

表 模 型 方法 与 具体 的 业务 逻辑 有 关 , 下 面 先 在 Wm Model Send 模型 中 添加 一 个 
getMessages 方法 ,用 它 获取 发 送 给 用 户 的 个 人 消息 。 代 码 如 下 : 


public function getMessages( $ where = array(), $ order = null) 
{ 
$ select = $ this -> select() -> setIntegrityCheck(false); 
$ select - » fron('tb send','* '); 
if (count( $ where) » 0)( 
foreach ( $ where as $ key => $ value)( 
$ select -> where('tb send. '. $ key. '- ?', $ value); 
) 
) 
if ( $ order)( 
$ select -> order('tb send'. $ order); 
}else{ 
$ select -> order( 'tb_send. sdat desc'); 
} 
$ select -> join( 'tb_receive', 'tb_send. id = tb receive. sid', 'readflg'); 
$ result = $ this - » fetchAll( $ select); 
if ( $ result){ 
return $ result; 
} 
else{ 
return null; 
} 
) 


该 方法 返回 发 送 给 某 个 用 户 的 个 人 消息 ,其 中 的 查询 条 件 通 过 “ 键 / 值 "数组 的 形式 带 入 
到 方法 中 。 结 果 集 的 排序 按照 用 户 的 指定 执行 ,如 果 用 户 没 有 指定 , 则 按 消息 发 送 的 时 间 降 
序 排列 。 该 方法 采用 了 联合 查询 的 方式 ,因为 在 显示 收 件 箱 中 的 消息 时 要 区 分 该 消息 是 否 
已 经 阅读 过 ,而 对 “是 否 阅 读 ” 的 判断 是 通过 tb_receive 表 中 的 readflg 字段 的 值 来 完成 的 ， 
所 以 ,在 传 给 视图 的 查询 结果 中 应 该 包括 readflg 字段 的 值 。 


9.3.3 设计 视图 文件 
1. 添加 控制 器 方法 代码 
准备 好 了 数据 库 、 表 模型 ,就 完成 了 业务 逻辑 的 处 理工 作 。 为 了 将 消息 在 页 面 上 显示 出 


来 ,还 必须 有 控制 器 方法 与 视图 文件 的 配合 。 
打开 上 面 创建 的 Message 控制 器 文件 application\controllers\MessageController. php ,在 
receive 方法 中 添加 如 下 代码 : 


public function receiveAction() 


{ 
$ username = $ this—> user 一 > getIdentity() -> username; 
$ where = array( 'sendto' = > $ username, 'sendedflg' -» 1); 
$ messages = $ this ->_sendMess -> getMessages( $ where) ; 
$ this -> view- > messages = $ messages; 

} 


在 方法 中 ,首先 通过 保存 的 用 户 认证 信息 获取 用 户 姓 名 (这 里 用 真实 姓名 进行 查询 ); 
然后 构造 查询 条 件 , 即 查询 写 给 用 户 username 并 且 已 经 发 送 的 消息 ; 最 后 将 查询 条 件 带 入 
模型 方法 ,并 将 结果 集 传递 给 视图 。 

2. 编写 视图 文件 代码 

从 本 章 9. 1 节 展 示 的 效果 可 以 看 出 ,个 人 消息 显示 页 面 主 要 由 导航 菜单 区 、 功 能 操作 区 
与 列表 显示 区 构成 ,为 此 ,将 视图 文件 也 进行 适当 分 割 。 页 面 的 CSS 样式 文件 统一 存放 在 
messagecss. php 的 文件 中 ; 左 侧 的 导航 菜单 存放 在 messageleft. phtml 中 ,在 控制 器 方法 对 
应 的 视图 文件 中 只 存放 右 侧 的 功能 区 与 列表 显示 区 的 内 容 。 

导航 菜单 视图 文件 messageleft. phtml 的 代码 如 下 : 


<div id= "mssidebar"> 
<div id = "topnenu" align="left"> 
< table border = "0" >< tr > 
<td id= "lefttitle"> 个 人 消息 </td> 
</tr ></table> 
</div> 
<ul class = "sidemenu"> 
<li><a href = "/message/receive"> 
< img src = "/images/ inbox. png" alt = " 收 件 箱 "> 收 件 箱 </a></1i> 
<li><a href =" # ">< img src = "/images/draft. png" alt = "草稿 箱 "> 
Snbsp; &nbsp; &nbsp;&nbsp; 草稿 箱 </a></1i> 
<li><a href = "/message/send"> 
< img src = "/images/senti. png" alt = " 送 件 箱 "> 发 件 箱 </a></1i> 
<li><a href =" # ">< ing src = "/images/delitem. png" alt = "垃圾 箱 "> 
&nbsp; &nbsp; &nbsp; &nbsp; 垃 圾 箱 </a></1i> 
<li><a href =" # ">< ing src = "/images/delitem1. png" alt = "清空 "> 
Snbsp; &nbsp; gnbsp; &nbsp; 清 空 垃圾 箱 </a></1i> 
</ul > 
</div> 


视图 文件 receive. phtml 的 代码 如 下 : 


<?php require once 'messagecss. php'?> 

<?php require once 'messageleft. phtml'?> 

<div id= "message">< div id = "mscontent"> 
<h2 class = "pagetitle"> 系 统 内 部 留言 : <b> 收 件 箱 </b></h2 > 
< div align= "left"> 
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<ul class = "messagemenu"> 
<li><a href - " # ">< ing src = "/images/addBtn. jpg" 
alt- "新 消息 "></a></1i> 
<li><a href =" # ">< ing src = "/images/queryBtn. jpg" 
alt = "检索 "></a></1i> 
</ul> 
<hr /> 
</div> 
<div id= "msmain"> 
< form name = "listForm" action=" #" method = "POST"> 
< input type = "hidden" name = "mode" value = "recieve"> 
< input type = "hidden" name = "max" value = "1"> 
<div align="left" style = "font- size:0. 8em"> 
<a id= "allselect" href = "javascript:;" onclick = "setSelect()"> 
全 部 选择 </a> | <a id= "allrelease" href = "javascript: ;" 
onclick = "setRelease( ) "> 解除 全 部 选择 </a> | 
<a id= "allreverse" href = "javascript:;" 
onclick = "setReverse()"> 全 部 反 转 </a>|</div> 
<br /> 
«div align="left"> 
< input class = "blog delete" type = "button" 
onclick = "listChk()" value = "删除 "> 
</div> 
<br/> 
< table class = "table - list"><thead><tr> 
«th class = "curve - left"> 发 件 人 </th> 
<th > 发 送 时 间 </th> 
<th class = "curve - right"> 标 题 </th> 
</tr ></thead>< tbody> 
<?php foreach ( $ this -> messages as $ key => $ message) :?> 
< tr class = "odd"»« td width = "100" valign= "top" class = "line - left nowrap" 
align="left" rowspan = "1"> 
< input type = "checkbox" name = "mid0" value = "11" /> 
< img src = "/images/ 
<?php echo $ message[ 'readflg'] ? 'obj read.gif': 'obj yet.gif'?2" > 
<?php echo $ message[ 'uid'] ?></td> 
< td class = "titlecell"»«?php echo $ message[ 'sdat'] ?></td> 
< td rowspan = "1" align = "left" class = "line - right"> 
<a href = " # "><?php echo $ message[ 'title'] ?></a></td> 
< input type = "hidden" name = "mode0" value = "recieve" /> 
</tr ><?php endforeach; ?» «/tbody >< tfoot >< tr» 
< td class = "curve - left"></td>< td></td>< td class = "curve - right"></td> 
«/tr »«/tfoot »«/table»«br /> 
<div align="left" style - "font - size:0.8em"» 
«a id- "allselect" href = "javascript:;" onclick = "setSelect()"> 全 部 选择 </a> 
| «a id= "allrelease" href = "javascript:;" onclick = "setRelease( ) "> 
解除 全 部 选择 </a> | <a id= "allreverse" href = "javascript: ;" 
onclick = "setReverse( )"> 全 部 反 转 </a>| «/div»«/form»«/div »«/div»«/div» 


上 述 代码 比较 多 .里 面 大 部 分 都 是 关于 页 面 布 局 的 ,在 学 习 时 请 大 家 参考 源 代码 ,要 特 
别 注意 代码 中 的 阴影 部 分 。 接 收 个 人 消息 的 M-V-C 现在 都 已 经 完成 了 ,打开 Apache 服务 


器 ,在 浏览 器 的 地 址 栏 中 输入 http://wmoams. com/message, 效 果 如 图 9. 8 所 示 。 


. dH tan (xm 


发 送 时 间 标题 


2015-06-12 00:00:00 请 到 学 校 领 时 公 务 卡 
| 全 汪洋 


ésas |NMeEBH|$55Ul 


图 9.8 用 户 消息 收 件 箱 页 面 


9.4 消息 的 发 送 


上 面 实现 了 用 户 个 人 消息 的 接收 ,本 节 实 现 消息 的 发 送 。 发 送 消息 是 通过 用 户 单 击 如 
图 9. 8 所 示 页 面 中 的 “新 增 "按钮 来 实现 的 ,该 按钮 对 应 Message 控制 器 中 的 send 方法 。 


9.4.1 设计 输入 表单 视图 


消息 发 送 时 ,用 户 需 要 在 页 面 的 输入 表单 中 填写 几 项 关键 内 容 , 这 些 内 容 主要 有 收 件 人 
姓名 、 消 息 主题 ,消息 内 容 等 。 为 了 简便 ,这 里 使 用 HTML 表单 接受 用 户 的 输入 , 且 只 进行 
简单 的 有 效 性 验证 。 当 然 ,大 家 也 可 以 用 Zend. Form 表单 ,与 HTML 表单 相 比 ,Zend_ 
Form 表单 具有 强大 的 验证 功能 ,但 其 装饰 显得 有 些 麻烦 。 

在 9. 3 节 中 已 经 创建 了 名 为 send 的 Message 控制 器 方法 ,现在 打开 这 个 方法 所 对 应 的 
视图 文件 application\views\scripts\message\send. phtml, 添 加 如 下 代码 : 


<?php require once 'messagecss. php'?» 
<?php require once 'nessageleft.phtml'?» 
<div id= "message"»« div id = "mscontent"^ 


< form name = 'createform ' action - "/message/send" method = " POST" onSubmit = " return 
checkSubnit()"» 
<table><tr > 

«td width= "10 & "> 收 件 人 </td> 

< td style = "width:70px;"»« input type = "text" id= "user" size- "20"></td> 

«td style = "width: 30px;">< input id = "adduser" class = "blog delete" type = "button" 
onclick = 'checkUser(" # ");' value = "添加 到 朋友 表 "/></td> 
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«td»« img id- "list" src = "/images/friend. gif" onclick =" displayList ()" title = "朋友 
列表 "></td> 

<td>< input name = users" id= "users" type = "hidden" value = ""» &nbsp;</td></tr > 
<tr><td> 主 题词 </td> 
< td colspan = "4">< input type = "text" name = "title" size= "48" maxlength = "120" value = ""> 
</td> 
</tr>< tr>< td colspan = "5">< textarea name = "contents" rows = "9" cols = "54"></textarea > 
</td></tr><tr> 
«td >< input class = "blog delete" type= "submit" onclick = "this. form. mode. value = '2'" value = " 保 
存 为 草稿 "></td> 
< td colspan- "4">< input class = "blog delete" type = "submit" value = "发 送 消息 "></td></tr> 
</table></form></div></div> 


视图 文件 被 泻 染 后 的 页 面 效 果 如 图 9. 9 所 示 。 
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9.9 用 户 消息 添加 页 面 


页 面 中 除 * 收 件 人 ”“ 主 题词? 和 ”消息 内 容 ” 表 单元 素 之 外 ,还 有 3 个 按钮 和 一 张 图 片 。 
3 个 按钮 为 “添加 到 朋友 表 ”、“ 保 存 为 草稿 "和 “发 送 消息 ”, 它 们 分 别 完成 将 新 收 件 人 添加 到 
用 户 好 友 列 表 、 将 待 发 消息 保存 到 草稿 箱 和 直接 发 送 消息 的 功能 。 页 面 中 的 图 片 是 用 户 好 
友 列 表 链 接 , 单 击 该 图 片 会 打开 用 户 的 好 友 列 表 ,供用 户 从 中 选择 收 件 人 。 


9.4.2 处 理 用 户 消息 表单 


1. 好 友信 息 的 显示 

用 户 单 击 图 9. 9 页 面 中 的 “好 友 ” 图 片 ,会 在 页 面 中 显示 该 用 户 的 好 友 列 表 供 用 户 选 择 ， 
好 友 列 表 中 的 好 友 姓 名 从 数据 表 tb_friend 中 获取 。 

1) 添加 视图 代码 

打开 视图 文件 application\ views\ scripts\ message\ send. phtml, 在 末尾 添加 如 下 
代码 : 


«div id= "FriendList" style = "display:none;position:absolute;top:180px; 
left:900px; width:80px; height: 200px; background: # CCC; float:left"» 


<?php echo $ this 一 > action('friendlist', message')?» 
</div> 


上 述 代码 中 的 阴影 部 分 使 用 Zend Framework 的 视图 助手 调用 了 Message 控制 器 的 


friendlist 方法 ,这 个 方法 暂时 还 没有 业务 逻辑 代码 , 稍 后 再 添加 。 


为 了 响应 用 户 对 “好 友 ” 图 片 的 单 击 操作 ,在 视图 文件 的 前 面 添加 如 下 JavaScript 函数 
displayList。 代 码 中 的 函数 setText 是 用 户 单 击 好 友 列 表 中 的 姓名 后 将 值 赋 给 “ 收 件 人 ” 表 


单元 素 的 函数 。 


< script type = "text/javascript"> 
function displayList()( 
var friendlist = document. getElementById("FriendList"); 
var displayMode - friendlist. style.display; 
if(displayMode == 'none')( 
friendlist. style. display = ""; 
}else{ 
friendlist. style. display = "none"; 
} 
} 
function setText(x)( 
var userInput = document. getElenentById("user"); 
userInput. value = x; 
) 


</script> 


2) 添加 模型 方法 


打开 模型 文件 application\models\Friend. php. Æ Wm, Model. Friend 类 中 添加 如 下 


方法 : 


class Wm Model Friend extends Zend Db Table 
{ 
protected $ name- 'tb friend'; 
public function getFriends( $ where = array()) 
{ 
$ select = $ this- » select(); 
if (count( $ where) > 0){ 
foreach ( $ where as $ key => $ value) { 
$ select - » where( $ key. ' = ?', $ value); 
} 
} 
$ result = $ this- » fetchRow( $ select); 
if ( $ result){ 
return $ result; 
} 
else( 
return null; 


) 


B I BCEIBA 
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3) 添加 控制 器 方法 
打开 上 面 创建 的 Message 控制 器 文件 application V controllers\ MessageController. 
php. Æ friendlist 方法 中 添加 如 下 代码 : 


public function friendlistAction() 
{ 
header( 'content - type: text/html; charset = utf - 8'); 
$ uid= $ this- >_user -> getIdentity() -> id; 
$ strFriends = $ this-» friend- » getFriends( 
array( 'uid' => $ uid) ) -> toArray() ; 
$ friends = explode( '# ', $ strFriends['friend']); 
$str-'; 
foreach ( $ friends as $k=> $ key) ( 
$ str . = < div style = "width:95 $ ; clear:both; 
background — color : # FFFFFF; cursor:pointer;" 
onmouseover = "this. style. background = \ ' # FF8900V'; 
this. style. color = \ ' # FFFFFEV'" 
onmouseout = "this. style. backgroundColor = \ ' # FFFFFF\ '; 
this. style. color = \ ' # 333333\'" onclick = "setText(V''. $key. V)" »'; 
$ str . = <ul>'; 
$str.-' <li style = "font - size:l3px;width:60 * ; height:18px; 
line- height:18px; text- align:center; float:left;"»'. $key. '«/li»'; 
$ str . = «/ul»'; 
$ str .= '«/div»'; 
} 
echo $ str; 
$ this- >_helper -> viewRenderer - > setNoRender() ; 
i: 


该 方法 通过 用 户 ID 调用 Wm_Model_Friend 模型 中 的 方法 获取 登录 用 户 的 好 友信 息 ， 
并 用 列表 的 形式 在 视图 页 面 中 进行 输出 。 

注意 方法 中 的 4 个 阴影 代码 块 ,第 1 个 阴影 代码 块 设置 好 友 列 表 页 面 编码 ; 第 2 个 阴 
影 代码 块 利 用 PHP 的 函数 explode 将 好 友 列 表 字 符 串 分 离 为 单个 的 “姓名 ”, 数 据 表 tb_ 
friend 中 的 friend 字段 中 存储 的 是 由 好 友 姓 名 组 成 的 用 *# ”号 分 隔 的 字符 串 , 见 表 9. 2; 
第 3 个 阴影 块 循环 输出 好 友 姓 名 ,并 设置 了 用 户 单 击 列表 项 的 操作 函数 setText, 该 函数 功 
能 见 上 述说 明 ; 最 后 一 句 阴 影 代码 使 用 Zend Framework 的 动作 助手 ,关闭 了 控制 器 方法 对 
应 的 视图 ,这 里 为 application\views\scripts\message\friendlist. phtml 视图 ,因为 好 友 列 表 
的 显示 需要 在 send. phtml 中 进行 。 关 于 Zend Framework 的 “助手 ”, 将 在 第 10、11 章 详 细 
介绍 。 

通过 上 述 3 个 步骤 的 准备 之 后 ,用 户 单 击 图 9. 9 页 面 中 的 好友” 图 片 将 会 在 页 面 中 显 
示 该 用 户 的 好 友 姓 名 列表 ,选择 列表 中 的 好 友 , 在 “ 收 件 人 ”表单 元 素 中 就 会 输入 该 好 友 的 姓 
名 ,效果 如 图 9. 10 所 示 。 再 次 单 击 “ 好 友 ” 图 片 , 关 闭 好 友 列 表 。 

4) 添加 新 好 友 

在 上 面 的 演示 中 ,使 用 的 示例 数据 都 是 直接 在 数据 库 中 添加 的 。 当 用 户 在 “ 收 件 人 ” 表 
单元 素 中 输入 姓名 后 ,可 以 单 击 页 面 中 的 “添加 到 朋友 表 ” 按 钮 将 该 收 件 人 姓名 添加 到 数据 
K tb. friend 中 。 这 个 操作 非常 简单 ,请 大 家 自己 完成 。 需 要 提醒 的 是 ,在 准备 写 和 数据库 


之 前 要 对 用 户 的 输入 进行 有 效 性 判断 ,并 进行 无 害 化 处 理 , 以 防 数据 库 攻 击 ; 在 数据 写 入 时 
还 要 进行 是 否 重 名 的 校 核 。 
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9.10 用 户 好 友 列 表 


2. 表单 数据 的 处 理 

用 户 在 页 面 中 输入 相关 内 容 并 通过 验证 后 ,如 果 单 击 “ 保 存 为 草稿 "按钮 , 则 该 消息 被 放 
入 用 户 草 稿 箱 中 ,暂缓 发 送 。 其 实 , 此 时 只 是 将 该 消息 保存 到 了 tb. send 数据 表 , 并 将 字段 
sendedflg 的 值 设置 为 "0? 而 已 ; 但 是 ,如 果 用 户 输入 完毕 , 单 击 的 是 “发 送 消息 ”按钮 , 则 完 
成 数据 的 保存 并 设置 字段 sendedflg 的 值 为 1 后 ,还 需要 将 该 消息 放 入 tb. receive 数据 表 
中 ,以 备 检 查 消息 的 状态 之 用 。 

打开 Message 控制 器 文件 ,在 方法 send 中 添加 代码 : 


public function sendAction() 
t 
if( $ this -> getRequest() -> isPost()){ 
$ date- $ this - > getRequest() - > getParans(); 
$ message[ 'sendto'] = $ date[ 'sendto']; 
$ nessage[ 'title']- $ date[ 'title']; 
$ nessage[ 'contents'] = $ date[ 'contents']; 
$ nessage[ 'uid'] = $ this- » user-» getIdentity() -> username; 
$ nessage[ 'cdat'] = $ message[ 'udat'] = 
$ nessage[ 'sdat'] = date('Y- m- d H:i:s',time()); 
if( $ date[ 'node'] == 1){ 
$ nessage[ 'sendedf1lg']- 1; 
$ id= $ this-- sendMess -> addMessage( $ message); 
$ this ->_receiveMess - > addMessage( 
array('sid' => $ id, 'udat' = > $ nessage[ 'sdat'])); 
} 
if( $ date[ 'mode'] == 2) { 
$ message[ 'sendedf1g'] = 0; 
$ this ->_sendMess - > addMessage( $ message) ; 
} 
$ this -> redirect( '/nessage/list/type/send'); 
} 
} 


该 段 代 码 分 3 个 步骤 完成 消息 的 发 送 功能 : 首先 判断 方法 的 调用 是 否 由 用 户 单 击 了 表 
单 的 “提交 ”按钮 引起 ,若是 , 则 取出 提交 的 数据 ,并 添加 一 些 其 他 字段 ; 然后 判断 用 户 单 击 
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的 “提交 ?按钮 是 “保存 为 草稿 5 还 是 "发送 消 息 ”; 最 后 根据 “提交 ”按钮 的 类 型 分 别 进行 数据 
库 操作 。 如 果 用 户 单 击 的 是 “发 送 消息 ”按钮 , 则 将 该 消息 同时 写 入 tb. send 和 tb. receive 
数据 表 中 ; 如 果 用 户 单 击 的 是 “保存 为 草稿 "按钮 , 则 只 需要 将 数据 写 入 tb_send 数据 表 。 


9.4.3 设计 数据 添加 模型 方法 


上 面 在 处 理 表单 数据 的 send 方法 中 用 到 了 tb_send 和 tb_receive 数据 表 模 型 的 
addMessage 方法 ,这 两 个 方法 的 实现 逻辑 是 相似 的 ,下 面 只 编写 tb. send 表 模 型 中 的 代码 。 
打开 application\models\ Send. php 模型 文件 ,添加 如 下 代码 : 


public function addMessage( $ data = array()) 
t 
$ row= $ this - » createRow() ; 
if (count( $ data) > 0){ 
foreach ( $ data as $ key => $ value) { 
$ row->$ key= $ value; 
} 
$ row- » save(); 
return $ row 一 > id; 


} 
else{ 
throw new Zend_Exception( ' 向 数据库 中 写 和 数据 出 错 ! ) ; 
} 
} 
用 户 提交 的 数据 以 “ 键 / 值 ” 数 组 的 形式 传人 该 方法 ,然后 调用 Zend Db Table 表 模 型 
的 createRow 方法 ,创建 一 个 Zend_Db_Table_Row_Abstract 对 象 ,也 就 是 tb_send 数据 表 
的 一 个 空 “ 行 ”, 接 着 依次 读 和 在 控制 器 的 send 方法 中 准备 好 的 数据 。 
注意 ,数据 数组 的 “ 键 / 值 ”一 定 要 与 表 tb_send 中 的 字段 名 称 相同 ,同时 还 要 注意 表 中 
字段 的 “ 空 ” 属 性 设置 ,否则 会 抛 出 数据 库 写 入 异常 。 数 据 正确 读 入 空 “ 行 ”对象 后 ,调用 
Zend Db Table Row. Abstract 类 的 save 方法 将 数据 写 入 数据 库 中 。 


9.5 消息 的 显示 


9.5.1 消息 的 分 类 显示 


从 上 面 的 页 面 效果 图 可 以 看 出 ,系统 的 留言 信息 管理 系统 结构 模拟 Web 邮件 系统 ,将 
个 人 消息 进行 了 分 类 存放 。 上 面 实现 了 查看 “ 收 件 箱 ” 中 消息 的 功能 ,下 面 介 绍 “ 发 件 箱 ”、 
“草稿 箱 ” 和 “垃圾 箱 ” 中 消息 的 查询 与 显示 。 

1. 添加 控制 器 方法 代码 

为 了 显示 “发 件 箱 ”“ 草 稿 箱 ” 和 “垃圾 箱 ” 中 的 消息 ,在 Message 控制 器 中 添加 一 个 名 
为 list 的 方法 。 在 Zend Studio 集成 开发 环境 中 打开 Message 控制 器 文件 ,在 list 方 法 中 添 
加 代码 : 


public function listAction() 


$ page = array(); 
$ type= $ this -> getRequest() -> getParam( type'); 
if( $ type == 'send')( 
$ page[ 'type'] = 'send'; 
$ pagel 'title'] = ' 发 件 箱 '; 
$ pagel 'tbtitle'] = ' 收 件 人 '; 
$ page[ 'tntitle']- ' 发 送 时 间 '; 
$ uid= $ this—> user -> getIdentity() 一 > username; 
$ where = array( 'uid' => $ uid, 'sendedflg'-» 1, 'delflg' => 0); 
$ messages = $ this- » sendMess - > getMessages( $ where); 
} 
if( $ type == 'draft')( 
$ page[ 'type'] = 'draft'; 
$ page[ 'title'] = ' 草 稿 箱 '; 
$ page[ 'tbtitle'] = ' 收 件 人 '; 
$ page[ 'tmtitle'] = ' 更 新 时 间 '; 
$ uid- $ this—> user -> getIdentity() -> username; 
$ where = array( 'uid' => $ uid, 'sendedflg' => 0, 'delflg' => 0); 
$ messages = $ this- » sendMess - > getMessages( $ where); 
) 
if( $ type == 'rub')( 
$ page[ 'type'] = 'rub'; 
$ pagel 'title'] = ' 垃 圾 箱 '; 
$ page[ 'tbtitle'] = ' 收 件 人 /发 件 人 '; 
$ page[ 'tmtitle'] = ' 发 送 / 更 改 时 间 '; 
$uid= $ this—> user -> getIdentity() -> username; 
$ wherel = array( 'uid' => $ uid, 'delflg' => 1); 
$ messagesl = $ this- » sendMess - » getMessages( $ wherel); 
$ where2 = array( 'sendto' => $ uid, 'delflg'-»1); 
$ messages2 = $ this- » sendMess -> getMessages( $ where2); 
$ messages = $ messagesl- » toArray() + $ messages2 -> toArray(); 
) 
$ this -> view - > page = $ page; 
$ this -> view -> messages = $ messages; 


} 

这 里 所 说 的 消息 的 分 类 实际 上 是 虚拟 的 ,数据 库 中 并 不 存在 与 之 对 应 的 数据 表 , 所 以 ， 
在 查看 信息 的 时 候 必须 知道 它 所 在 的 虚拟 分 类 名 称 。 在 上 述 list 方法 中 ,type 用 来 保存 分 
类 名 称 , 它 的 值 由 视图 页 面 中 菜单 的 链接 传递 ,其 中 字符 串 send, draft, rub 分 别 表示 “发 件 
箱 ”“ 草 稿 箱 ”" 和 “垃圾 箱 ”; 代码 中 的 page 是 自 定义 的 页 面 信息 数组 ,因为 在 显示 不 同 的 
“ 箱 ” 里 的 消息 时 ,要 显示 的 字段 ,标题 文字 是 不 一 样 的 。 例 如 ,在 查看 发 件 箱 时 要 输出 “ 收 件 
人 ”, 而 在 查看 垃圾 箱 时 要 输出 “发 件 人 ”或 “ 收 件 人 ”。 

做 好 适当 的 准备 工作 之 后 ,就 可 以 分 门 别 类 地 执行 查询 了 。 查 询 时 直接 调用 模型 中 的 
getMessages 方法 就 可 以 得 到 相应 的 结果 集 ,这 里 的 难点 主要 在 查询 条 件 的 构造 上 。 查 询 
条 件 与 数据 库 的 设计 有 关 , 根 据 9. 2 节 中 给 出 的 数据 表 结 构 ,查询 条 件 如 下 : 

。 RFR: 由 “我 "创建 .已 经 发 送 、 没 有 被 删除 。 即 


EEE FERR 


Bow 
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array( 'uid' => $ uid, 'sendedflg'-» 1, 'delflg' => 0) 

。 草稿 箱 : 由 "我 ”创建 .没有 发 送 .没有 被 删除 。 即 

array( "uid' =>$ uid, 'sendedflg' => 0, 'delflg' => 0) 

* 垃圾 箱 : 由 “我 "创建 ,已 经 被 删除 或 发 送 给 “我 ”已 经 被 删除 。 即 


array( 'uid' = > $ uid, 'delflg'=>1) 


array( 'sendto' = > $ uid, 'delflg'-» 1) 


2. 添加 视图 代码 
list 方法 的 视图 与 receive 方法 的 视图 相似 ,只 是 要 根据 不 同 的 类 型 进行 输出 。 下 面 是 
部 分 代码 : 


<?php foreach ( $ this 一 > messages as $ key => $ message) :?> 

<?php if( $ this -> page[ 'type'] == 'send') :?> 

«tr class = "odd"> 

<td width = "100" valign = "top" class = "line- left nowrap" align= "left" rowspan = "1"> &nbsp; 
&nbsp;&nbsp;&nbsp;« input type = "checkbox" name =" " value=" " />< img src = "/images/obj | 
read. gif" ><?php echo $ nessage[ 'sendto'] ?></td> 

< td class = "titlecell"»«?php echo $ nessage[ sdat'] ?></td> 

< td rowspan = "1" align="left" valign = "middle" class = "line - right"»« a href =" /message/ 
detail/type/send/id/«?php echo $ message[ id'] ?>"> 

<?php echo $ message[ 'title'] ?» «/a»«/td» 

</tr> 

<?php endif; ?> 


9.5.2 消息 的 详细 显示 


1. 添加 控制 器 方法 
打开 Zend Studio 集成 开发 环境 中 的 ZF Tool 工具 窗口 ,输入 命令 : 


zf create action detail Message 
在 Message 控制 器 中 创建 detail 方法 ,并 添加 代码 : 


public function detailAction() 
{ 
$ page = array(); 
$ type= $ this -> getRequest()—> getParam( 'type'); 
$ id= $ this -> getRequest() - > getParan('id'); 
$ message = $ this->_sendMess - » find( $ id) -> current(); 
$ page[ 'sendto'] = $ nessage[ 'sendto']; 
$ page[ 'sendtoname'] = "I: fF A '; 
$ page[ 'sendby'] = $ nessage[ 'uid']; 
$ page[ 'sendbynane'] = ' 发 件 人 '; 


$ page[ 'nessagetitle']- $ message[ title']; 
$ page[ 'nessagebody'] = $ nessage[ 'contents']; 
if( $ type == 'receive')( 
$ page[ 'time'] = $ nessage[ 'sdat']; 
$ page['tntitle'] = ' 发 送 时 间 '; 
} 
if( $ type == 'send')( 
$ page[ 'time'] = $ nessage[ 'sdat']; 
$ page[ 'tntitle']- ' 发 送 时 间 '; 
} 
if( $ type == 'draft')( 
$ page[ 'time'] = $ nessage[ 'udat']; 
$ page[ 'tmtitle'] = "ERAH '; 
} 
if( $ type == 'rub'){ 
$ page[ 'tine'] = $ nessage[ 'udat']; 
$ page[ 'tmtitle'] = ' 更 改 时 间 '; 


} 
$ this -> view—>page= $ page; 
} 


消息 详细 显示 时 ,页 面 内 容 从 数组 page 中 取出 ,数组 page 中 的 值 根据 不 同 的 消息 来 源 
在 detail 方法 中 赋值 。 上 述 代 码 中 的 第 2、3 行 提取 从 视图 页 面 传递 过 来 的 页 面 类 型 与 消息 
的 序号 “id”, 所 以 ,必须 在 receive. phtml 或 list. phtml 视图 文件 的 链接 中 添加 这 两 个 参数 。 


2. 添加 视图 代码 
打开 detail 方法 的 视图 文件 application\ views\scripts\message\detail. phtml, 添加 


代码 : 


<div id = "msmain"> 

<div align="left" style= "font - size:0.8em"> <a href - " #" onclick = "answer()" > 回信 </a> 
|<a href =" #" onclick- "forward()" > 转送 </a> 

| «a href 2" &" onclick = "" > 删除 </a>|<a href =" #" onclick = "editMessage()" > 

编辑 此 留言 </a> | <ahref="#" onclick="" > 留言 一 览 </a> </div><br><hr /> 

<table> 

«tr ><td width = "15 & "> 消息 标题 : </td> 

<td><?php echo $ this -> page[ 'nessagetitle']?»«/td» </tr> 

<tr><td><?php echo $ this -> page[ 'sendbyname']?>:</td><td> 

<?php echo $ this -> page[ 'sendby']?» «/td »«/tr» 

«tr»«td»«?php echo $ this -> page[ 'tntitle']?»: «/td»« td> 

<?php echo $ this -> page[ 'tine']?» «/td » «/tr» 

«tr»«td»«?php echo $ this 一 > page[ 'sendtoname']?»: «/td»« td» 

<?php echo $ this -> page[ 'sendto']?» «/td»«/tr» 

<tr>< td> 消 息 内 容 : «/td»« td colspan = "4"»« textarea name = "contents" rows = "3" cols = "54" > 
<?php echo $ this -> page[ 'nessagebody']?» «/textarea ></td></tr > 

</table> 

</div> 


Bow 


代码 中 省 略 的 部 分 与 list. phtml 或 receive. phtml 相似 ,页 面 效 果 如 图 9. 11 所 示 。 
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主题: 请 到 学 院 领取 公务 卡 


发 件 人 : 汪洋 


时 间 : 2015-06-12 00:00:00 


BFA: "Um 


AS: 由 学 校 统一 申请 的 公务 卡 已 经 办 好 ， 请 老师 们 到 学 办 领取 ! “^ 


9.11 用 户 消息 详情 页 面 


9.6 消息 的 移动 与 删除 


上 面 为 个 人 消息 设置 了 虚拟 的 消息 “ 箱 ”, 实 现 了 消息 的 分 类 管理 。 这 一 节 继 续 完善 消 
息 的 管理 功能 ,实现 消息 的 移动 与 删除 。 


9.6.1 消息 的 移动 


所 谓 消 息 的 移动 ,是 指 把 消息 从 “ 收 件 箱 ”“ 发 件 箱 ”“ 草 稿 箱 ” 转 移 到 “垃圾 箱 ” 的 过 程 
以 及 其 逆 过 程 ,下 面 用 一 个 控制 器 方法 来 实现 这 个 功能 。 

1. 添加 控制 器 方法 

打开 Zend Studio 集成 开发 环境 ,在 ZF Tool 工具 窗口 中 输入 命令 : 


zf create action move Message 
在 Message 控制 器 中 创建 move 方 法 ,并 添加 代码 : 


public function moveAction() 
í 
$ type= $ this - > getRequest() - > getParan('type'); 
if( $ this - > getRequest() — > isPost()){ 
$ date= $ _POST; 
if( $ type != 'rub'){ 
foreach ( $ date as $ mess){ 
$ this-» sendMess - > updateMessage( 
$ ness, array( 'delflg'-»1)); 
) 


if ( $ type-- 'receive') { 


$ this -> redirect( '/nessage/receive') ; 
}else{ 
$ this -> redirect ( '/nessage/list/type/'. $ type); 
} 
}else{ 
foreach ( $ date as $ mess)( 
$ this- » sendMess - > updateMessage( 
$ ness, array( 'delflg'-»0)); 
) 
$ this -> redirect( '/nessage/list/type/rub'); 
) 
} 
$ this - » redirect ( '/message') ; 
) 


程序 首先 判断 方法 的 调用 是 否 来 自 于 表单 的 提交 ,注意 这 里 的 表单 提交 是 指 对 页 面 中 
“删除 ?或 “还 原 ” 按 钮 的 操作 。 如 果 是 用 户 单 击 了 按钮 ,接着 根据 页 面 的 类 型 进行 不 同 的 操 
作 。 如 果 消 息 不 在 “垃圾 箱 ” 中 , 则 执行 将 消息 移入 “垃圾 箱 ” 的 操作 ,否则 ,执行 还 原 操作 。 

将 消息 移入 “垃圾 箱 ” 的 方法 很 简单 ,获取 到 选中 消息 的 id 后 ,调用 send 模型 的 
updateMessage 方法 将 该 消息 的 delflg 字段 的 值 更 改 为 “1” 即 可 。updateMessage 方法 是 自 
定义 的 send 模型 方法 ,现在 还 不 存在 ,我 们 在 下 面 的 小 节 中 添加 。 消 息 的 id 是 通过 页 面 中 
的 checkbox 表单 元 素 的 值 传递 过 来 的 。 

把 “垃圾 箱 ” 中 的 消息 还 原 到 原来 的 位 置 ,只 要 将 该 消息 的 delflg 字段 的 值 重新 还 原 为 
“0” 即 可 。 

2. 添加 send 模型 方法 

打开 send 模型 文件 application\models\Send. php, 添 加 updateMessage 方法 ,代码 
如 下 : 


public function updateMessage( $ id, $ data = array()) 
( 
$ row- $ this - » find( $ id) -> current(); 
if( $ row)( 
if (count( $ data) » 0)( 
foreach ( $ data as $ key - » $ value)( 
$ row-»$ key- $ value; 
) 
$ row- » save(); 
return $ row—> id; 
) 
else( 
throw new Zend_Exception( ' 向 数据 库 中 写 入 数据 出 错 ! ') ; 
Jelse ( 
return false; 
) 
) 
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对 象 技术 的 优势 所 在 。 调 用 updateMessage 模型 方法 只 需要 传人 两 个 参数 ,一 个 是 需要 修 
改 的 消息 的 序号 ,用 它 可 以 准确 地 定位 消息 ; 另 一 个 就 是 需要 修改 的 字段 与 值 组 成 的 键 / 值 
数组 。 

代码 中 使 用 Zend Db Table Abstract 类 的 find 方法 ,通过 传人 的 消息 序号 获取 到 该 
消息 的 原始 记录 ,然后 对 数据 进行 更 改 、 保 存 。 需 要 注意 的 是 ,find 方法 是 通过 数据 表 的 主 
键 进行 查找 操作 的 ,默认 主键 名 为 id, 如 果 数 据 表 中 的 主键 名 不 为 id, 则 需要 在 模型 中 进行 
声明 。 这 个 问题 在 前 面 的 章节 中 已 有 说 明 ,这 里 再 强调 一 下 。 

3. 修改 视图 文件 

模型 和 控制 器 准备 就 绪 后 , 接 下 来 修改 视图 文件 。 消 息 移动 的 效果 是 通过 查询 的 方式 
展现 出 来 的 ,在 这 里 ,我 们 弃 用 move 方法 的 move. phtml 视图 ,在 list 方法 的 视图 文件 list. 
phtml 中 修改 代码 完成 消息 的 显示 。 下 面 只 给 出 需要 修改 的 关键 代码 。 


«h2 class=" "> 系统 内 部 留言 : <?php echo $ this- » page[ 'title'] ?> </h2 > 
从 list 方法 传递 给 页 面 的 page 中 取出 消息 * 箱 ”的 名 称 ， 


< form nane = "listForm" 
action = "/message/move/type/«?php echo $ this -> page[ 'type']?»" 
method = "POST"> 
将 表单 数据 以 post 的 方式 提交 到 Message 控制 器 的 move 方法 进行 处 理 , 同 时 以 get 
方式 将 页 面 类 型 type 也 传递 到 move 方法 中 : 


< input class = "blog delete" type = "button" onclick = "listChk()" 
value = "<?php echo $ this -> page[ 'type'] == 'rub'? ' 还 原 ': ' 删 除 '?>"> 


如 果 是 在 “垃圾 箱 " 页 面 ,将 “删除 "按钮 的 标签 更 改 为 还原”: 


«th class = "curve - left"»«?php echo $ this - » page[ 'tbtitle'] ?></th> 
< th ><?php echo $ this -> page[ 'tntitle'] ?» «/th» 


列表 显示 消息 时 ,不 同 页 面 表 头 文字 不 一 样 : 


< input type = "checkbox" name = "<?php echo 'mid'. $ message[ 'id'] ?>" 
value = "<?php echo $ message[ 'id'] ?>" /> 
这 是 消息 列表 中 每 条 消息 第 一 列 中 的 多 选 表单 元 素 ( 即 chechkbox) fff] name, value 属 
性 设置 。 这 两 处 代码 非常 重要 ,用 户 的 选择 就 是 通过 这 种 方式 将 消息 的 id 传递 到 move 77 
法 中 的 。 
另外 ,大 家 可 能 感到 奇怪 ,在 视图 页 面 中 并 没有 看 到 form 表单 的 “提交 ”按钮 ,那么 是 怎 
样 进行 表单 提交 的 呢 ? 请 查看 页 面 中 “删除 ”按钮 的 属性 ,里 面 有 一 个 onclick, 它 的 值 为 
listChkO ,这 是 JavaScript 函数 ,代码 如 下 : 
function listChk(e)( 
var inputList - document. listForm. elements; 
var count = 0; 
for (var i=0; i< inputList.length; i++) { 
var input = inputList[i]; 


if(input.type == 'checkbox' && input. checked == true) 
count++; 


} 

if(count == 0){ 
alert( ' 请 选择 要 移动 的 消息 ! ); 
return false; 


} 
document. listForm. submit(); 


return true; 


} 


该 函数 先 检查 用 户 是 否 选择 了 需要 移动 的 消息 ,如 果 有 选择 , 则 执行 表单 的 提交 操作 。 

到 现在 为 止 ,M-V-C 模式 中 的 3 项 都 已 准备 完毕 ,下 面 就 可 以 在 浏览 器 中 进行 测试 了 ， 
效果 如 图 9. 12 一 图 9. 14 所 示 。 图 9. 12 为 “发 件 箱 ” 页 面 , 在 这 里 选择 了 第 2 条 消息 , 单 击 
“删除 ?按钮 ,数据 被 提交 到 move 方法 ,处 理 完毕 后 重新 回 到 “发 件 箱 ”, 如 图 9. 13 所 示 。 从 
该 图 中 可 以 看 出 ,move 方法 正确 移 除了 第 2 条 消息 。 打 开 “ 垃 圾 箱 ”, 如 图 9.14 所 示 , 可 以 
看 到 “发 件 箱 ” 中 的 消息 被 移 到 “垃圾 箱 ” 中 。 
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图 9.12 选择 发 件 箱 消息 


9.6.2 消息 的 删除 


消息 的 物理 删除 通过 菜单 中 的 “清空 垃圾 箱 ” 完 成 。 从 上 面 的 分 析 可 知 ,“ 垃 圾 箱 ” 中 的 
消息 既 可 能 来 自 于 tb. send 表 , 也 可 能 来 自 于 tb. receive 表 。 所 以 ,删除 消息 必须 将 两 个 表 
中 的 关联 数据 全 部 删除 ,这 种 在 关联 表 之 间 进 行 的 操作 称 为 级 联 操作 。 

级 联 操作 可 以 在 数据 库 层 面 解决 ,主流 的 数据 库 都 支持 CASCADE 级 联 ,所 以 通常 涉 
及 关联 删除 或 更 新 时 可 以 在 数据 库 中 使 用 SQL 语句 建立 级 联 操作 。Zend Framework 的 数 
据 库 抽象 层 与 数据 库 无 关 , 如 果 更 换 数据 库 ,Zend Framework 程序 仍旧 能 正常 工作 ,不 会 
因此 出 现任 何 问 题 。 所 以 ,Zend Framework 的 Zend Db 提供 了 代码 层面 的 级 联 功能 ,以 使 
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9.14 垃圾 箱 页 面 效 果 


不 依赖 数据 库 就 可 以 实现 数据 的 级 联 操作 。 

1. 修改 模型 文件 

如 果 要 实现 数据 表 tb. send 与 tb. receive 的 级 联 操作 ,需要 对 它们 对 应 的 模型 文件 进 
行 修改 , 即 在 模型 中 定义 级 联 关系 。 

打开 Send. php, Receive. php 模型 文件 ,分别 添加 如 下 代码 : 


class Wm Model Send extends Zend Db Table 


{ 
protected $ name- 'tb send'; 


protected $ dependentTables = array( Wm Model Receive'); 


} 


class Wm Model Receive extends Zend Db Table 
{ 
protected $ name- 'tb receive'; 
protected $ referenceMap = array( 
'Post' => array( 


'colums' => array('sid'), 
'refTableClass' => 'Wm Model Send', 
'refColumns' => array( 'id'), 
'onDelete" => self::CASCADE 


) 

Zend Db Table Abstract 3i 33 dependentTables Wü referenceMap 表示 表 间 关系 。 
dependentTables 表示 依赖 于 本 表 的 类 名 , 它 是 一 个 数组 ,在 其 中 可 以 配置 多 个 依赖 表 。 注 
意 , 这 里 使 用 的 是 表 模 型 的 类 名 ,例如 代码 中 的 Wm_Model_Receive。 

如 果 要 让 Zend Db Table 级 联 更 新 和 删除 ,需要 明确 父 表 和 子 表 , 被 依赖 的 表 一 般 作 
为 父 表 ,依赖 其 他 表 的 表 作 为 子 表 ,这 里 (b. send 为 父 表 、tb_receive HTK. 

在 父 表 中 配置 了 dependentTables ,在 子 表 中 也 要 相应 配置 referenceMap。referenceMap X 
示 本 表 对 其 他 表 的 依赖 关系 , 它 也 是 一 个 数组 ,数组 的 每 一 个 元 素 代表 一 种 映射 关系 ,该 映 
射 关 系 由 映射 名 ,本 表 引 用 字段 .被 引用 表 名 ,被 引用 字段 等 构成 ,如 代码 所 示 。 各 配置 项 的 
含义 如 下 : 
columns; 用 一 个 字符 串 或 者 数组 表示 的 依赖 表 的 外 键 。 一 般 情况 下 , 它 是 一 个 单 
独 的 字段 ,有 些 表 也 可 能 是 多 个 字段 。 

* refTableClass: 父 表 的 类 名 ,而 不 是 表 名 。 

。 refColumns: 父 表 中 的 主键 ,一 般 情 况 下 它 也 是 一 个 字段 ,有 的 表 可 能 有 多 个 字段 。 

。 onDelete: 父 表 中 删除 记录 时 的 操作 。 

* onUpdate: 父 表 中 主键 被 修改 时 的 操作 。 

模型 经 过 如 此 配置 后 就 具备 了 级 联 删 除 功能 ,所 以 当 用 户 删 除 “垃圾 箱 ” 中 的 消息 时 ,如 
果 该 消息 来 自 于 “ 收 件 箱 ”, 则 该 消息 在 tb_receive 中 的 记录 也 会 一 起 被 删除 。 

另外 ,在 tb. send 表 模 型 中 青 添加 一 个 删除 方法 ,代码 如 下 : 


public function deleteMessage( $ id) 
{ 

$ row= $ this - » find( $ id) -> current(); 
if( $ row)( 

$ row- » delete(); 
}else{ 

throw new Zend Exception( ' 删 除 消息 出 错 ! ) ; 第 
) 9 
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2. 创建 控制 器 方法 
打开 Zend Studio 集成 开发 环境 的 ZF Tool 工具 窗口 ,输入 命令 : 


zf create action delete Message 


在 Message 控制 器 中 创建 delete 方法 ,并 添加 代码 : 


public function deleteAction() 
{ 
$ messages = $ this ->_sendMess - > getMessages(array( 'delflg' => 1)); 
foreach ( $ messages as $ mess){ 
$ this ->_sendMess- > deleteMessage( $ ness[ 'id']); 
} 
$ this -> redirect( '/nessage/list/type/rub'); 
} 
该 方法 首先 获取 tb_send 中 字段 delflg 的 值 为 "1 的 所 有 消息 ,这 些 消 息 就 是 “垃圾 箱 ” 
中 的 全 部 消息 ; 然后 遍历 结果 集 , 提 取消 息 的 id 并 删除 。 由 于 已 经 定义 了 级 联 操作 ,所 以 
删除 操作 虽然 调用 的 是 tb_send 的 表 模 型 方法 deleteMessage, 数 据 表 tb. receive 中 的 关联 
消息 会 一 起 被 删除 。 


9.7 本 章 小 结 


本 章 详细 介绍 了 系统 内 部 留言 功能 的 实现 过 程 , 是 学 习 Zend Framework 应 用 的 工作 
原理 .MVC 机 制 ,数据库 操 作 layout 布局 模板 以 及 组 件 使 用 的 又 一 综合 实例 。 内 部 留言 系 
统 是 应 用 系统 内 部 用 户 之 间 短 暂 交 流 与 沟通 的 平台 , 它 综合 了 常用 即时 通信 工具 及 邮件 系 
统 的 特点 ,是 办 公 自 动 化 管理 系统 中 不 可 或 缺 的 功能 模块 。 

本 章 留言 系统 界面 是 按照 Web 邮件 系统 的 要 求 做 成 的 ,设置 了 收 件 箱 .草稿 箱 发 件 箱 
与 垃圾 箱 以 及 消息 发 送 页 面 。 在 学 习 过 程 中 ,在 读者 进一步 巩固 前 面 所 学 知识 的 同时 应 重 
点 掌握 利用 数据 库 实现 复杂 业务 逻辑 的 方法 以 及 Zend Framework 的 数据 库 级 联 操作 。 
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行政 事务 是 指 国家 机 关 、 企 事业 单位 和 社会 团体 内 部 的 日 常 管理 事务 与 各 项 服务 ,例如 
收发 文档 、 接 竺 来宾 . 收 支 买办 、 车 辆 、 安 全、 福利 卫生、 后 勤 补 给 及 保障 等 。 这 些 事务 虽然 
都 比较 琐碎 ,但 至 关 重 要 ,事务 处 理 的 高 效 与 否 直接 关系 到 企业 的 内 、 外 部 形象 。 

本 章 实现 办 公 自 动 化 管理 系统 的 部 分 事务 管理 功能 ,包括 申请 管理 .报修 管理 .车 辆 管 
理 等 ,由 此 介绍 Zend Framework 的 视图 助手 ,并 进一步 熟悉 Zend Framework 相关 组 件 的 
使 用 。 


10.1 事务 信息 管理 效果 预览 


根据 第 3 章 的 总 体 规 划 , 本 系统 设置 了 专门 的 事务 信息 管理 模块 用 来 处 理 各 部 门 及 用 
户 个 人 的 行政 管理 事务 。 该 模块 功能 位 于 导航 菜单 的 “事务 管理 ” 主 菜单 下 ,包括 “领导 日 
程 "”“ 公 用 申请 ”“ 请 假 管理 ”“ 印 章 管 理 ”“ 车 辆 管理 ”“ 报 告 意见 ”等 。 这 里 的 “领导 日 程 ” 
是 指 领导 接待 日 程 安排 ;“ 公 用 申请 ”是 指 一 些 临 时 性 的 安排 申请 ,例如 借用 教室 、 会 议 室 、 
报告 厅 、 实 验 室 等 。 由 于 事务 管理 非常 琐碎 ,涉及 的 部 门 及 人 员 也 非常 多 ,其 实现 比较 复杂 ， 
这 里 只 介绍 “申请 管理 ”功能 的 实现 过 程 。 下 面 是 系统 事务 信息 管理 的 部 分 页 面 效果 。 

1. 事务 管理 模块 主页 

图 10. 1 所 示 为 用 户 单 击 “ 事 务 管理 ” 主 菜单 后 的 页 面 效 果 , 页 面 左 侧 的 快捷 菜单 设置 了 
“ 待 办 事务 "及 “在 办 事务 "两 个 子 菜单 项 ,方便 用 户 随时 查看 事务 完成 的 情况 ; 页 面 右 侧 为 
重要 事务 及 个 人 工作 安排 中 急需 完成 的 任务 的 “ 待 办 提醒 ”, 它 的 内 容 由 用 户 自行 设置 ; 中 
间 部 分 为 “事务 管理 ”的 主 显示 区 。 

2. 全 部 事务 管理 页 面 

图 10. 2 所 示 为 用 户 单 击 “ 事 务 管理 " 主 菜单 后 的 主页 面 效 果 , 页 面 分 左 、 右 两 部 分 , 左 侧 
为 导航 菜单 ,同时 也 是 事务 信息 的 分 类 显示 菜单 ,这 里 设置 了 “全 部 事务 ”“ 待 办 事务 ”"“ 在 
办 事务 ”“ 已 办 事务 ”“ 在 审 事务 ”5 种 分 类 形式 ; 右 侧 又 分 为 上 、 下 两 个 区 域 , 上 面 为 操作 
区 ,下 面 为 事务 信息 详细 显示 区 。 

该 图 中 显示 的 是 与 该 用 户 有 关 的 全 部 事务 ,每 件 事务 除 显示 开始 日 期 \ 主 题 及 内 容 外 ， 
还 用 红色 字体 显示 了 该 事务 的 处 理 状态 ,让 用 户 对 已 完成 未 完成 .审核 中 的 事务 都 能 一 目 
了 然 。 

3. 在 审 事务 管理 页 面 

图 10. 3 所 示 为 用 户 单 击 “在 审 事务 " 子 菜单 后 的 页 面 效 果 ,页面 右 下 区 显示 的 是 申请 已 
经 提交 、 正 在 等 待 批复 的 事务 详情 ; 上 面 操作 功能 区 列 出 了 登录 用 户 能 够 对 事务 信息 进行 


PHP Zend Framework 5t A FA E 2 RUHE 


amona 1 
NEIN PTET Led 
taa AR TT 
全 HS 站 
aex BEN isni >resnmxsoas sae 
ER eH 
TAB 22 | '^sisunsranurem, nibus STE, HESS 107, 
Imat ) anane: aam: ( 9 工作 安排 
ae - 
re [ perpe p 
Lue 20. | rns) swomzapamaTE, aew: -TEPE 
E] -一 
| EEE 
20 | (ASi smasnsniaaacn, PAREEN. 
EMEN em cawa waoe 
15 | (ASI 由 于 工作 原因 ，2014 8 20EXRESEEEUOR. 
一 Pg - 
[Id DET 


10.1 事务 管理 主页 面 


事务 管理 事务 管理 : 全 部 事务 
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10.2 全 部 事务 页 面 


的 各 种 操作 ,这 些 操作 是 由 用 户 的 权限 决定 的 。 

图 中 功能 区 显示 了 “批复 "按钮 ,说 明 登 录用 户 具有 审批 的 权限 , 单 击 该 按钮 ,进入 “申请 
审批 ?页 面 , 在 这 里 可 以 查询 到 需要 该 用 户 审批 的 所 有 事务 申请 详情 ,并 对 每 件 事务 进行 处 理 。 

4. 待 办 事务 管理 页 面 

图 10. 4 所 示 为 用 户 单 击 “ 待 办 事务 " 子 菜单 后 的 页 面 效 果 , 页 面 右 下 区 显示 的 是 申请 已 
经 批复 、 正 在 等 待 用 户 处 理 的 事务 详情 ,包括 事务 申请 原文 及 审核 批复 原文 ,同时 在 事务 申 
请 原文 的 标题 旁 设置 “ 收 件 ”超级 链接 ,用 于 修改 该 事务 的 处 理 状态 ,用 户 单 击 该 链接 , 即 可 
将 该 事务 状态 从 “ 待 办 ”修改 为 “在 办 ”。 
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图 10.3 在 审 事 务 页 面 
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图 10.4 待 办 事务 页 面 


5. 添加 事务 管理 页 面 

图 10. 5 所 示 为 用 户 单 击 操作 功能 区 中 的 “新 增 ” 按 钮 后 的 页 面 效 果 。 添 加 事务 信息 就 
是 向 数据 库 表 中 写 和 数据, 因此 要 求 表单 元 素 与 数据 表 字 段 吻合 。 这 里 设置 了 “标题 "“ 类 
型 "“ 内 容 ” 及 “审批 人 ”4 种 表单 元 素 接收 用 户 的 输入 。 
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10.2 数据 库 设 计 


根据 第 3 章 的 总 体 设计 ,本 系统 中 事务 信息 管理 的 数据 表 由 “事务 表 ” 与 “批复 表 ” 组 成 。 
“事务 表 ” 用 来 记录 全 部 的 事务 信息 ,对 该 表 执 行 不 同 条 件 的 查询 ,可 以 获取 不 同类 型 的 事务 
信息 的 集合 ;“ 批 复 表 ” 用 来 记录 对 事务 申请 的 批复 , 它 是 “事务 表 ” 的 子 表 。 


10.2.1 事务 信息 数据 表 的 设计 


事务 信息 数据 表 存 储 用 户 提交 的 全 部 事务 信息 ,为 了 方便 查询 与 分 类 ,通过 数据 表 的 字 
段 能 够 获取 事务 的 如 下 信息 。 

1. 事务 类 型 

事务 申请 从 本 质 上 来 说 是 前 面 第 8 章 所 述 的 “公文 ”的 一 种 ,因此 它 的 类 型 应 该 是 tb_ 
doctype 数据 表 中 的 值 , 它 依赖 数据 表 tb_doctype。 

2. 事务 申请 人 

由 于 是 Web 应 用 ,系统 所 有 用 户 提 交 的 事务 申请 均 存储 在 该 表 中 ,因此 必须 记录 事务 
的 申请 人 信息 。 在 这 里 可 以 直接 用 字符 串 记 录 申 请 人 姓名 ,也 可 以 先 记 录用 户 id, 再 通过 id 
在 用 户 表 tb_user 中 查询 申请 人 的 其 他 信息 。 如 果 采 用 后 一 种 方法 , 则 “事务 表 ” 又 会 依赖 
“用 户 表 ”tb_user。 

3. 事务 主题 与 内 容 

事务 的 主题 与 内 容 是 事务 的 主体 ,通过 数据 库 的 模糊 查询 可 以 从 事务 的 主题 与 内 容 详 
情 中 提取 相关 的 分 类 信息 。 

4. 事务 审核 人 

在 添加 事务 申请 的 时 候 , 用 户 必 须 选 择 该 申请 提交 的 部 门 或 个 人 ,不 同类 型 的 事务 由 不 
同 的 部 门 进行 处 理 。 事 务 的 审核 部 门 或 个 人 也 应 该 与 “部 门 表 ”tb_depart 或 “用 户 表 ”tb_ 
user 相对 应 。 

5. 事务 处 理 状态 

从 一 件 事务 的 生命 周期 来 看 , 它 应 该 处 于 编辑 审核. 待 办 、 在 办 和 办 结 中 的 某 一 个 状 
态 , 不 同 状 态 的 事务 ,其 处 理 与 显示 方式 的 侧重 点 稍 有 不 同 。 例 如 处 于 * 审 核 ” 状 态 的 事务 ， 
不 仅 申请 人 能 够 查询 ,同时 必须 让 审核 人 也 能 够 查询 ; 而 处 于 “ 待 办 ”、“ 在 办 ”等 状态 的 事 
务 , 与 审核 人 就 没有 太 大 的 关系 了 。 

这 里 所 列举 的 只 是 一 些 常用 的 字段 设置 ,在 项 目 开发 过 程 中 还 要 根据 具体 情况 进行 适 
当 的 调整 。 表 10. 1 列 出 了 本 系统 事务 数据 表 的 字段 名 称 及 作用 。 

表 10.1 tb affair 数据 表 的 功能 说 明 


字段 名 说 Hg 

id 自 增 变量 ,主键 ,事务 的 唯一 标识 

typeid 事务 类 型 ,例如 请 示 .报告 .意见 等 ,与 tb_doctype 数 据 表 的 id 字段 对 应 
title 事务 主题 


content 事务 详情 


续 表 


字段 名 说 明 

uid 事务 申请 人 ID ,与 tb. user 数据 表 的 id 字段 对 应 

cdat 事务 申请 提交 时 间 

checkid 事务 审核 人 ID, 与 tb. user 数据 表 的 id 字段 对 应 

replyid 事务 批复 ID ,与 tb. reply 数据 表 的 id 字段 对 应 

state 事务 状态 ,0、1、2、3、4 分 别 表示 编辑 、 审 核 , 待 办 、 在 办 和 办 结 状态 
prompt 事务 摘要 ,用 于 “ 待 办 提醒 ”功能 的 显示 


根据 表 10. 1 中 的 字段 及 功能 说 明 , 用 命令 方式 或 用 phpMyAdmin 数据 库 管理 工具 创 
建 事务 表 tb_affair, 如 图 10.6 所 示 。 


£z ”类 型 排序 规则 Et 空 默认 S 
id int(4) € X — AUTO INCREMENT 
typeid  int(4) 否 无 

title ^ varchar20) gb2312 chinese ci 否 无 
content varchar(200) gb2312 chinese ci Sx 

uid int(4) Sx 

cdat — in(11) mEE 
checkid int(4) Sx 
replyid | int(4) 是 NULL 
state — tinyint(1) Sox 
prompt varchar20) 9b2312 chinese ci Sx 


图 10.6 tb affair 事务 信息 数据 表 


10.2.2 事务 批复 数据 表 的 设计 
事务 批复 数据 表 是 事务 信息 数据 表 的 子 表 , 只 需 记 录 批 复 详情 及 审核 人 、 批 复 日 期 即 
可 。 如 果 需 要 直接 从 “批复 表 ” 中 查找 该 批复 对 应 的 事务 申请 ,也 可 以 设置 一 个 记录 事务 ID 
的 字段 ,让 该 字段 与 tb_affair 的 id 相对 应 。 
事务 批复 数据 表 的 字段 设置 与 作用 见 表 10. 2。 
表 10.2 tb reply 数据 表 的 功能 说 明 


字段 名 说 明 
id 自 增 变量 ,主键 ,事务 批复 的 唯一 标识 
title 事务 批复 主题 
content 事务 批复 详情 
checker 事务 审核 人 ID, 与 tb. user 数据 表 的 id 字段 对 应 
cdat 事务 批复 时 间 


根据 表 10. 2 中 的 字段 及 功能 说 明 , 用 命令 方式 或 用 phpMyAdmin 数据 库 管 理工 具 创 


建 事务 表 tb_reply, 如 图 10.7 所 示 。 第 
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名 字 o x 排序 规则 属性 m RU SOR 

id int(4) Æ Æ AUTO INCREMENT 
title ^ varchar20) gb2312 chinese ci EZ 

content varchar(200) gb2312 chinese ci Sx 

Checker varchar(20) 9b2312 chinese ci EEN 

cdat int(11) Sox 


10.7 tb reply 事务 批复 数据 表 


10.3 事务 信息 的 显示 


事务 信息 的 显示 过 程 实际 上 就 是 一 个 数据 库 的 分 类 查询 过 程 。 从 10. 1 节 中 给 出 的 页 
面 效果 可 以 看 出 ,本 系统 除了 能 显示 全 部 事务 的 详情 及 状态 外 ,还 将 事务 分 成 了 在 审 、 待 办 、 
在 办 和 已 办 4 种 类 型 。 下 面 实现 这 些 事务 的 分 类 显示 。 


10.3.1 创建 控制 器 及 方法 


为 了 对 事务 信息 进行 管理 , 需 设 置 相 应 的 控制 器 及 方法 ,控制 器 及 方法 的 创建 这 里 还 是 
采用 Zend Studio 集成 开发 环境 提供 的 Zend Framework 工具 完成 。 

1. 生成 控制 器 及 方法 

启动 Zend Studio 集成 开发 环境 ,选择 项 目 工 作 区 中 的 wmProject, 通 过 菜单 打开 ZF 
Tool 工具 窗口 ,输入 命令 : 


zf create controller Affair 


在 默认 模块 default 中 创建 事务 管理 控制 器 Affair。 然 后 用 同样 的 方法 打开 Zend Tool T.H. 
窗口 ,输入 命令 : 


zf create action list Affair 


在 控制 器 Affair 中 创建 list 方法 。 

2. 初始 化 控制 器 

通过 上 面 的 Zend Framework 工具 创建 了 Affair 控制 器 及 方法 list, 同 时 关联 地 创建 了 
控制 器 的 init, index 方法 以 及 相应 的 视图 文件 index. phtml 和 list. phtml。 为 了 下 面 编程 
方便 ,在 Affair 控制 器 中 定义 user、affair、reply 3 个 对 象 ,分 别 表示 登录 用 户 、 事 务 模型 . 批 
复 模型 ,并 在 init 方法 中 对 其 初始 化 。 代 码 如 下 : 


class AffairController extends Zend Controller Action 
{ 
protected $ _user = null; 
protected $ _affair = null; 
protected $ reply- null; 
public function init() 
{ 
$ auth= Zend_Registry: :get( 'auth'); 
if( $ auth-> hasIdentity()){ 


$this-» user- $ auth; 
} 
$ this-» affair- new Wm Model Affair(); 
$ this-» reply- new Wn Model Reply(); 


) 

代码 中 的 Wm Model. Affair 与 Wm Model. Reply 为 10. 2 节 中 创建 的 tb. affair, tb 
reply 数据 表 的 表 模 型 ,现在 它们 还 不 存在 ,将 在 10.3.2 节 中 创建 。 用 户 信息 从 用 户 认 证 信 
息 对 象 auth 中 提取 。 


10.3.2 创建 数据 表 模 型 及 方法 

在 上 面 的 控制 器 初始 化 代码 中 创建 了 “事务 表 ” 模 型 对 象 $ _affair 与 “批复 表 ” 模 型 对 
Z$ _reply, 通 过 这 两 个 对 象 可 以 对 “事务 表 ” 和 “批复 表 ” 进 行 操作 。 

1. 创建 模型 

打开 Zend Studio 集成 开发 环境 中 的 ZF Tool 工具 窗口 ,分别 输 入 命令 : 

zf create model Affair 

和 

zf create model Reply 


创建 Wm Model Affair 与 Wm Model Reply 模型 类 ,为 类 添加 基 类 及 相应 的 数据 表 
名 ,代码 如 下 : 
class Wm Model Affair extends Zend Db Table 


{ 
protected $ name- 'tb affair'; 


} 


class Wm Model Reply extends Zend Db Table 
( 
protected $ name- 'tb reply'; 


i 

2. 添加 方法 

打开 模型 文件 application\ models\ Affair. php. 为 表 模 型 Wm_Model_Affair 添加 
getAffairs 方法 及 addAffair 方法 .代码 如 下 : 


public function getAffairs( $ where = array(), $ order = null) 
{ 
$ select = $ this-» select(); 


if (count( $ where) > 0)( 第 
foreach ( $ where as $ key - » $ value)( 10 
$ select -> where( $ key. ' = ?', $ value); 章 
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} 
} 
if ( $ order){ 
$ select -> order( $ order); 
} 
$ result = $ this -> fetchAll( $ select); 
if ( $ result){ 
return $ result; 
} 
else{ 
return null; 
} 
J 


表 模 型 Wm Model. Affair 的 getAffairs 方法 用 来 执行 对 数据 表 (b. affair 的 查询 操作 ， 
查询 条 件 由 where 从 调用 程序 中 带 入 ,查询 结果 集 的 排序 由 变量 order 确定 。 这 里 的 查询 
条 件 只 考虑 了 键 / 值 数组 的 形式 ,也 就 是 说 ,查询 的 条 件 只 能 用 “二 ”条 件 运 算 符 进行 处 理 ,如 
果 要 在 查询 条 件 中 使 用 “! 二 “二 ”“<" 等 其 他 条 件 运 算 符 ,还 必须 在 方法 中 添加 能 够 处 理 
以 字符 串 形 式 表 示 的 条 件 语句 的 代码 。 另 外 ,方法 中 的 查询 与 排序 子 句 都 是 通过 where 与 
order 方法 的 形式 添加 到 查询 对 象 中 的 。 代 码 中 的 select 为 查询 对 象 , 它 是 Zend Db Table | 
Select 实例 ,以 这 种 方式 进行 查询 ,可 以 有 效 地 防止 数据 库 的 注入 攻击 。 


public function addAffair( $ data = array()) 
{ 


$ row= $ this—> createRow(); 
if (count( $ data) > 0){ 
foreach ( $ data as $ key => $ value) { 
$ row->$ key = $ value; 
} 
$ row - > save(); 
return $ row 一 > id; 
) 


else( 
throw new Zend_Exception( ' 向 数据 库 中 写 人 数据 出 错 ! '); 
} 

} 

表 模 型 Wm_Model_Affair 的 addAffair 方法 用 来 执行 对 数据 表 tb_affair 的 添加 记录 
操作 ,记录 数据 由 data 数组 带 入 。 

在 方法 代码 中 ,首先 创建 一 个 Zend_Db_Table_Row_Abstract 对 象 , 暂 且 把 它 理 解 为 数 
据 表 tb_affair 的 一 个 空 “ 行 ”, 然 后 通过 循环 将 带 入 的 数据 按照 键 / 值 对 形式 读 和 人 到 这 个 空 
“ 行 ? 中 ,最 后 保存 并 返回 添加 的 新 记录 的 id 值 。 从 这 段 代码 可 以 看 出 , 带 入 数据 的 data 数 
组 的 “ 键 " 必 须 与 数据 表 tb_affair 的 字段 名 完全 吻合 , 且 不 能 有 多 余 的 数据 项 ,否则 操作 会 
抛 出 异常 ,请 大 家 特别 注意 。 

完成 Wm Model Affair 表 模 型 的 设计 后 ,接着 打开 模型 文件 application \ models V 
Reply. php ,为 表 模 型 Wm_Model_Reply 添加 getReply 方法 ,代码 如 下 : 


public function getReply( $ where = null, $ order = nu11)( 
if(is numeric( $ where))( 
$ row= $ this -> find( $ where) -> current() ; 
}else{ 
$ row- $ this -> fetchRow( $ where, $ order); 
} 
if ( $row) { 
return $ row; 
}else { 
return null; 
} 
} 


10.3.3 事务 信息 的 全 部 显示 


图 10. 2 所 示 为 事务 信息 全 部 显示 时 的 页 面 效 果 , 它 是 在 用 户 单 击 “ 事 务 管理 ”" 主 菜单 后 
出 现 的 ,显示 在 Affair 控制 器 的 index 视图 页 面 中 。 这 里 的 全 部 事务 信息 是 指 用 户 提交 的 
信息 ,不 包括 具有 审批 权限 的 用 户 的 批复 信息 。 批 复 信 息 在 用 户 单 击 * 批 复 " 按 钮 后 的 视图 
页 面 显示 。 

1. 编写 index 方法 代码 

打开 Affair 控制 器 文件 application\controllers\AffairController. php ,在 其 index 方法 
中 添加 如 下 代码 : 

public function indexAction() 

í $ uid= $ this->_user -> getIdentity() -> id; 

$ affairs = $ this->_affair -> getAffairs(array( 'uid' => $ uid), 'cdat desc'); 
$ this -> view- >affairs = $ affairs; 

} 

要 显示 用 户 的 所 有 事务 信息 ,就 是 要 在 (b. affair 数据 表 中 查询 字段 uid 的 值 等 于 用 户 
ID 的 所 有 记录 ,因此 首先 必须 获取 登录 用 户 的 ID。 

代码 中 的 第 1 句 , 通 过 前 面 定 义 的 _user 对 象 调用 Zend Auth 类 的 getIdentity 方法 ,从 
登录 认证 信息 中 直接 提取 用 户 的 ID; 第 2 句 , 通 过 _affair 模型 对 象 调 用 getAffairs 模型 方 
法 , 带 入 uid= $ uid 查询 条 件 ,获取 所 有 用 户 事务 信息 ,并 对 结果 集 按 edat 字段 降序 排列 ; 
第 3 句 , 将 查询 到 的 结果 集 通 过 affairs 传递 到 视图 中 。 

2. 编写 index 方法 的 视图 代码 

根据 10. 1 节 中 展示 的 页 面 结构 ,我 们 将 事务 信息 管理 模块 的 视图 文件 分 成 3 个 部 分 ， 
HI affairmenu. phtml,index. phtm 和 affaircss. php ,它们 分 别 代表 事务 信息 导航 区 .事务 信 
息 详情 区 与 页 面 CSS 布局 。 

index. phtm 视图 文件 的 代码 如 下 : 

<?php require_once 'affaircss. php'?> 

<?php require once 'affairmenu. phtm]'?> 


< div id = "message"»« div id = "mscontent"» 
<h2 class= "pagetitle"> 事 务 管理 : <b> 全 部 事务 </b></h2 > 
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<div align- "left" 
<ul class = "nessagenenu"» 
<li><a href = "/affair/apply"» 
< img src = "/images/addBtn. jpg" alt = "添加 "></a></1i> 
<li><a href="#"> 
< img src = "/images/queryBtn. jpg" alt = "检索 "></a></1i> 
</ul> 
<hr /» 
</div> 
<div id= "msmain"» 
<?php foreach ( $ this- >affairs as $ affair) :?> 
<?php 
switch ( $ affair['state']) ( 
case 1: $ str = '[8i rh... ] '; break; 
case 2: $ str = '[ 等 待 办 理 .….] '; break; 
case 3: $ str = '[ IE TEZME...] '; break; 
case 4: $ str = '[ GL. Zé 5E JL] '; break; 
default: $ str = ''; break; 
} 
?> 
< table style = "background:url(/images/date — bg2. gif) 
no- repeat left top;margin - top:5px"> 
<tr><td width = "60px" align= "center"> 
<?php echo date('m', $ affair[ 'cdat'])?>Ħ </td> 
< td style = "line - height :30px; border - bottom: 1px dashed # ff8800"> 
"标题 "<?php echo $ affair[ 'title']?> &nbsp;&nbsp;« font color = 'red'> 
<?php echo $ str ?»«/font »«/td»«/tr» 
«tr style = "line ~ height :30px;border - bottom: 1px solid # ff8800"> 
< td style = "font - weight : bold; font - size:24px;text ~ align:center; "> 
<?php echo date( 'd', $ affair[ 'cdat'])?></td> 
<td>[ 内 容 |<?php echo $ affair[ 'content']?></td></tr > 
</table> 
<?php endforeach; ?> 
</div> 
</div></div> 


代码 中 使 用 了 switche- case 结构 来 确定 每 件 事 务 的 处 理 状态 文本 ,这 是 因为 数据 表 tb 


_affair 中 的 状态 字段 state 的 数据 类 型 为 整 型 ,显示 时 要 输出 相应 的 文本 。 


在 视图 文件 中 使 用 这 么 多 的 PHP 代码 ,在 以 MVC 为 模型 的 Zend Framework 项 目 中 
显然 不 是 一 个 好 的 处 理 方 法 ,有 悖 于 数据 的 处 理 与 显示 分 离 的 程序 设计 原则 。Zend 
Framework 提供 了 一 种 称 为 “视图 助手 ”的 处 理 技术 来 解决 在 视图 文件 中 执行 复杂 操作 的 


问题 ,相关 内 容 将 在 稍 后 的 小 节 中 进行 介绍 。 


接着 看 上 述 代码 ,代码 的 第 2 句 包含 了 affairmenu. phtml 视图 文件 ,其 内 容 如 下 : 


<div id = "mssidebar"> 
<div id = "topmenu" align = "left">< table border = "0" > 
<tr><td id- "lefttitle"> 事 务 管理 </td></tr »«/table»«/div» 
« ul class = "sidemenu"> 
<li><a href = "/affair"» 


< ing src = "/images/calendar2. gif" alt = "全 部 事务 "> 
&nbsp; &nbsp; &nbsp; &nbsp; 全 部 事务 </a></1i> 
<li><a href = "/affair/list/state/2"» 
< img src = "/images/clock. gif" alt = " 待 办 事务 "> 
Snbsp; &nbsp; &nbsp; &nbsp; 待 办 事务 </a></1i> 
<li><a href = "/affair/list/state/3"» 
< img src = "/images/info_query. gif" alt = "在 办 事务 "> 
&nbsp;&nbsp;&nbsp;&nbsp; 在 办 事务 </a></1i> 
<li><a href = "/affair/list/state/A"» 
< img src = "/images/contract. gif" alt = "已 办 事务 "> 
&nbsp; &nbsp; &nbsp; &nbsp; 已 办 事务 </a></1i> 
<li><a href = "/affair/list/state/1"> 
< ing src = "/images/senti. png" alt = "在 审 事务 "> 
&nbsp; &nbsp; &nbsp; &nbsp; 在 审 事务 </a></1i> 
</ul> 
</div> 


10.3.4 待 办 事务 的 显示 


待 办 事务 信息 的 显示 效果 如 图 10.4 所 示 , 页 面 中 不 仅 显 示 了 事务 申请 的 详情 ,同时 还 
显示 了 该 事务 的 批复 内 容 ,以 方便 用 户 确定 下 一 步 的 操作 方式 。 上 面 介 绍 的 所 有 事务 的 显 
示 是 由 控制 器 的 index 方法 实现 的 ,属于 事务 信息 管理 模块 的 主页 ;“ 待 办 事务 ”"“ 在 办 事 
务 " 等 分 类 显示 用 控制 器 的 list 方法 统一 完成 。 

1. 编写 list 方法 代码 

打开 Affair 控制 器 文件 application\controllers\AffairController. php ,在 其 list 方 法 中 
添加 如 下 代码 : 


public function listAction() 
( 
$ page = array(); 
$ state- $ this - » getRequest() - > getParan( 'state'); 
$uid- $this-» user-»getIdentity() -> id; 
$role-  $this-» user-»getIdentity() -> role; 
Switch ( $ state) ( 
case '1': 
$ page = array( 'title' =>' 您 的 申请 正在 审核 中 ,请 等 待 .…); 
$affairs- $this-» affair-»getAffairs( 
array( 'uid' => $ uid, 'state' => 1), 'cdat desc"); 
break; 
case '2': 
$ page = array( 'title' =>' 待 办 事务 '); 
$affairs- $ this->_affair -> getAffairs( 
array( 'uid' => $ uid, 'state' => 2), 'cdat desc'); 
break; 
case '3': 
$ page = array( 'title'=>' 在 办 事务 '); 
$affairs- $ this->_affair -> getAffairs( 
array( 'uid' => $ uid, 'state' => 3), 'cdat desc'); 
break; 
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case '4': 
$ page = array( 'title' -» (17^ SEA '); 
$affairs- $ this—> affair-»getAffairs( 
array( 'uid' => $ uid, 'state' => 4), 'cdat desc'); 
break; 
} 
$ page = array_merge(array('role' => $ role), $ page); 
$ this -> view- > page= $ page; 
$ this -> view- »affairs- $ affairs; 


ji 


该 方法 通过 一 个 switch…case 结构 ,根据 请 求 中 的 state 参数 值 来 确定 事务 信息 的 显示 
类 型 。 在 每 个 case 小 节 中 ,程序 均 完成 两 件 事情 ,一 是 设置 视图 页 面 的 信息 , 即 变 量 page 
的 赋值 ; 二 是 从 数据 表 tb_affair 中 查询 满足 条 件 的 事务 信息 集合 , 即 为 变量 affairs 赋值 。 
查询 过 程 调用 上 面 定义 的 模型 方法 完成 ,代码 非常 简单 ,这 里 不 再 袭 述 。 

代码 中 的 变量 role 表示 登录 用 户 的 “角色 ”, 也 就 是 用 户 权限 , 它 的 值 从 登录 认证 信息 
中 提取 得 到 。 之 所 以 要 获取 用 户 的 权限 ,是 因为 在 视图 中 的 某 些 操作 ,比如 “批复 ”等 ,是 由 
不 同 的 用 户 权限 决定 的 ,不 同 的 用 户 打 开 的 视图 页 面 , 其 页 面 元 素 会 有 所 不 同 。 代 码 中 的 倒 
数 第 4 行 , 使 用 函数 array_merge 将 “用 户 权 限 ” 添 加 到 page 数组 中 ,以 便 将 其 传递 到 视 
图 中 。 

2. 编写 list 方法 的 视图 代码 

list 方法 的 视图 代码 与 前 述 index 方法 的 代码 基本 相似 ,不 同 的 是 在 显示 “ 待 办 事务 ”时 
需要 同时 显示 批复 的 内 容 , 因 此 在 list 方法 的 视图 文件 中 需 根据 事务 状态 确定 是 否 有 批复 
内 容 显 示 。 

list. phtm 视图 文件 的 部 分 代码 如 下 ,省 略 的 部 分 与 index. phtml 相同 。 


<?php foreach ( $ this 一 >affairs as $ affair):?> 
< table style = "background:url(/images/date - bg2. gif) 
no- repeat left top;margin- top:5px"> 
<tr><td width = "60px" align = "center" 
<?php echo date( 'm', $ affair[ 'cdat'])?>Ħ </td> 
< td style = "line- height : 30px; border - bottom: 1px dashed # ff8800"> 
"标题 "<?php echo $ affair['title']?> &nbsp;&nbsp; 
<a href 2 " # ">< font color = "red"> 
<?php echo $ affair['state'] == 2?'[ 收 件 ]':…?> 
</font ></a></td></tr> 


<?php if( $ affair['replyid'] && $ affair[ 'state'] == 2){ 

$ model = new Wn Model Reply(); 

$ reply- $ model -> getReply( $ affair[ replyid']); 
?> 
< table style = "background:url(/images/date — bg2. gif) 

no- repeat left top;margin- top:5px"» 
<tr><td width = "60px" align = "center" 
<?php echo date('m', $ reply['cdat'])?> 月 </td><td style = "line - height : 30px; 
border - bottom: 1px dashed # ff8800"> 


< font color = "red">" 批 复 "</font> 
<?php echo $ affair[ 'title']?></td></tr> 
«tr style = "line- height:30px;border - bottom: 1px solid # ff8800"» 
< td style = "font - weight:bold;font- size:24px;text — align:center; "> 
<?php echo date( 'd', $ reply[ 'cdat'])?» «/td»« td > 
| 内 容 |<?php echo $ reply[ 'content']?» «/td»«/tr» 
«tr style = "line- height:30px;border- bottom: 1px solid # ff8800"» 
< td style = "font - weight:bold;font- size:24px;text ~ align:center; "> 
«/td »« td »| 批准 人 |<?php echo $ reply[ 'checker']?» «/td »«/tr» 
</table> 
<?php }?> 
<?php endforeach;?> 


代码 中 直接 使 用 Wm Model Reply 模型 方法 getReply 获取 事务 的 批复 详情 ,这 也 不 
符合 MVC 的 程序 设计 理念 ,在 后 面 的 小 节 中 将 用 视图 助手 完成 这 项 功能 。 


10.4 事务 信息 的 添加 


事务 信息 的 添加 与 前 面 章 节 中 所 介绍 的 用 户 信息 文件 信息 等 的 添加 是 基本 相同 的 ,只 
是 对 应 的 数据 表 不 同 而 已 。 在 前 面 的 各 种 信息 添加 过 程 中 ,我们 使 用 的 是 Zend Form 表单 
对 象 ,对 它 的 使 用 相信 大 家 都 已 经 非常 熟悉 了 ,下 面 使 用 Zend Framework 的 Zend. View 组 
件 提供 的 一 种 新 方法 ( 即 “ 视 图 助手 ”) 来 实现 事务 信息 的 添加 。 


10.4.1 事务 信息 添加 方法 的 创建 


启动 Zend Studio 集成 开发 环境 ,选择 项 目 工作 区 中 的 wmProject 项 目 ,通过 菜单 打开 
ZF Tool 工具 窗口 ,输入 命令 : 


zf create action add Affair 
在 事务 信息 管理 控制 器 Affair 中 创建 add 方法 ,并 在 方法 中 添加 如 下 代码 : 


public function addAction() 
{ 
if( $ this - > getRequest() 一 > isPost()){ 
$ data= $ this -> getRequest() -» getPost(); 
$ affair = array( 
'title' => $ data['title'], 
'content' => $ data[ 'body'], 
'typeid' => $ data[ 'typeid'], 
'uid'=>$ this- >_user -> getIdentity() -> id, 
'checkid' => $ data[ 'typeid'], 
'cdat' => time(), 
'state' -»21 
) 
$ this->_affair -> addAffair( $ affair); 
$ this -> redirect( '/affair/list/state/1'); 
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$ modeUser = new Wn Model User(); 
$ users = $ modeUser — > getUsers("role !- 'user'"); 
foreach ( $ users as $ checker)( 

$ arrayNanme[ ] = $ checker[ 'usernane']; 

$ arrayId[] = $ checker[ 'id']; 
) 
$ checkers = array combine( $ arrayId, $ arrayName) ; 
$ this -> view 一 > checkers = $ checkers; 


} 


当 用 户 单 击 事务 管理 页 面 中 的 “新 增 ” 按 钮 后 ,页 面 跳 转 至 Affair 控制 器 的 add 方法 ,并 
泻 染 add. phtml 视图 ,页 面 效 果 如 图 10. 5 所 示 。 

从 图 中 可 以 看 出 ,表单 中 的 事务 "类型"“ 审 批 人 ”是 通过 选择 确定 的 ,页 面 显示 时 就 应 
该 对 选项 进行 初始 化 。 为 了 简单 ,这 里 的 “类 型 直接 在 视图 中 赋予 固定 值 ;“ 审 批 人 ”从 数 
据 库 中 读 和 人 。 上 述 代 码 的 倒数 第 2 行 至 倒数 第 8 行 完 成 “审批 人 ”的 查询 与 数组 准备 工作 。 
事务 审批 人 从 用 户 表 中 查询 得 到 ,他 们 是 拥有 审批 权限 的 一 批 人 。 由 于 数据 表 tb_affair 中 
的 checkid 字段 存储 的 是 tb. user 表 中 的 id, 而 页 面 中 显示 的 是 审批 人 的 姓名 ,所 以 在 程序 
中 重新 构造 了 一 个 名 为 checkers 的 数组 , 它 的 ”* 键 ?为 审批 人 的 id, 它 的 “ 值 ” 为 审批 人 的 姓 
名 ,用 这 个 数组 对 页 面 中 的 “审批 人 ”表单 元 素 进 行 初始 化 。 

如 果 用 户 填 写 完毕 各 项 表单 内 容 , 单 击 “ 提 交 ” 按 钮 ,数据 也 被 提交 到 add 方法 中 。 这 
时 ,程序 首先 接收 表单 数据 ,然后 依据 tb_affair 数据 表 的 字段 补 齐 表单 中 缺少 的 各 项 字段 
值 ,最 后 调用 Wm. Model. Affair 中 的 addAffair 方法 将 事务 信息 写 人 数据 表 中 。 


10.4.2 事务 信息 添加 视图 的 设计 


Zend Framework 的 Zend_View 组 件 是 用 来 在 MVC 模式 中 处 理 View( 视 图 ) 部 分 的 一 
个 类 ,是 用 来 使 View、Model 及 Controller 部 分 的 代码 分 离 的 。 它 提供 了 helper、output 
filter, variable escaping 等 几 个 功能 组 件 ,其 中 的 helper 就 是 “视图 助手 ”(View Helper), F 
面 用 它 来 编写 添加 事务 信息 的 表单 视图 。 

打开 视图 文件 application\views\scripts\affair\add. phtml, 并 编写 代码 : 


<div id= "msmain"> 
< form action = "/affair/add" method = "post" 
OnSubmit = "return check(this)" > 
< table class = "sheet"> 
<tr><th> 标 题 </th><td> 
<?php echo $ this -> formText( 'title',null,array( 
'size' 2750, 'style' = >'padding:5px') )?></tr > 
<tr><th> 类 型 </th><td> 
<?php echo $ this -> formSelect( 'typeid', ' 请 示 ',array( 
'style'=>'width:80px; height :25px; margin:5px; padding:3px'), 
array('3'=>' 请 示 ', '4'=>' 报 告 ', '5'=>' 意 见 '))?></td></tr> 
<tr><th> 内 容 </th>< td> 
<?php echo $ this -> formTextarea( 'body', null, array( 
'rows' => 8, 'cols' => 65, 'style' = >'margin:2px'))?></td></tr> 
<tr><th> 审 批 人 </th><td> 


<?php echo $ this -> fornSelect( 'checkerid',null, 
array('style'- »'width:120px; height:25px; 
nargin:5px; padding:3px'), $ this -> checkers)?» «/td » «/tr» 

«tr»«th»&nbsp;c/th»« td> 

<?php echo $ this - > formSubmit(null, ' 提 交 ',array( 

'style' = >'width: 50px; height:25px; ;margin:5px'))?» «/td»«/tr» 
</table> 
</form> 


< script type = "text/javascript"> 
gaess 
function check(theform) 


{ 
if(theform. title. value == "") 
{ 
alert(" 请 输入 标题 !"); 
theform. title. focus(); 
return false ; 
} 
if(theform. body. value -- "") 
{ 
alert(" 请 输入 内 容 !"); 
theform. body. focus( ) ; 
return false ; 
} 


return true ; 
} 
//--» 
</script> 
这 里 为 了 简单 ,没有 添加 表单 数据 验证 代码 ,只 是 简单 地 用 了 一 个 JavaScript 函数 
check 来 提示 用 户 填写 "标题 ”及 “内 容 ”。 
注意 : 代码 中 表单 元 素 的 创建 方法 , 它 既 不 是 Zend_Form 表单 对 象 , 也 不 是 传统 的 
HTML 表单 元 素 ,它们 是 Zend. View 视图 对 象 $ this 调用 基本 视图 助手 方法 来 完成 的 。 
代码 中 的 formText formSelect, formSubmit 为 Zend. View 自 带 的 helper 类 的 方法 ,它们 
的 功能 及 使 用 将 在 下 一 节 介绍 。 


10.5 Zend View 视图 助手 


TE Zend Framework 项 目的 开发 过 程 中 ,经 常 需要 在 视图 中 执行 某 些 复杂 功能 ,例如 格 
式 化 日 期 ,生成 表单 对 象 ,或 者 显示 action 的 链接 等 。 这 些 工作 都 可 以 使 用 视图 助手 类 完 
成 ,就 像 10. 4. 2 节 中 所 做 的 那样 。 


10.5.1 基本 视图 助手 类 


所 谓 “ 助 手 ”, 就 是 Zend Framework 定义 或 用 户 自 定义 的 一 些 简单 的 类 ,与 一 般 的 类 不 : 
同 的 是 ,助手 类 的 名 称 及 方法 的 定义 具有 某 种 特定 的 要 求 。 章 
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打开 Zend Framework 库 文件 的 View 目录 ,可 以 看 到 里 面 有 一 个 名 为 Helper 的 文件 


夹 ,这 里 存放 的 就 是 一 些 基本 的 视图 助手 类 ,如 图 10. 8 所 示 。 


Ji Navigation Ji Partial Ji Placeholder 

[E Action.php. 8 BaseUrl.php. I$) Currency.php. 

[S] DeclareVars.php. iS] Doctype.php. 回 Fieldsetphp 

[E FormButton.php. |] FormCheckbox.php. (8) FormElement.php. 
[S] FormFile.php. | FormHidden.php. S] Formimage.php. 

[B] FormMultiCheckbox.php. (8 FormNote.php. (8) FormPassword.php. 
(S) FormReset.php. |] FormSelect.php (8) FormSubmit.php. 
| FormTextarea.php. | Gravatar.php. 

| HeadScript.php | HeadStyle.php. 

|) HtmlFlash.php. IS] Htmltistphp. 

[E] HtmiQuicktime.php [S InlineScript php 

[8 Layout.php 8) Navigation.php. 

[S] PartialLoop.php. |) Placeholder.php. S] RenderToPlaceholder.php 
[8] Translate.php. iS Ur.php (8| UserAgent.php. 


图 10.8 基本 视图 助手 的 文件 目录 
打开 图 10. 8 所 示 目 录 中 的 FormText. php 文件 ,内 容 如 下 : 


require once 'Zend/View/Helper/FormElement. php'; 


class Zend View Helper FormText extends Zend View Helper FormElement 
{ 


public function formText( $ name, $ value = null, $ attribs = null) 
{ 
$ info= $ this->_getInfo( $ name, $ value, $ attribs); 
extract( $ info); // name, value, attribs, options, listsep, disable 
// build the element 
$ disabled = ''; 
if ( $ disable) { 
// disabled 
$ disabled = ' disabled = "disabled" '; 
) 
$ xhtml = '< input type = "text" " 
$ this -> view -> escape( $ name) . '"' 
$ this -> view 一 >escape( $ id). '""' 
$ this -> view- > escape( $ value) . '"" 


. 'namez"', 
wo adu e 
. 'valuez"', 
. $ disabled 
. $this-» htmlAttribs( $ attribs) 
. $ this- » getClosingBracket(); 


return $ xhtml; 


} 


回 Abstractphp 

回 cydephp 

国 Formphp 

回 FormErrorsphp 
8 FormLabel.php. 
[8| FormRadio.php. 
|j FormText.php. 
[9| HeadMeta.php 
|] HtmlElement.php. 
加 HtmlPage.php. 
E Json.php 

回 parialphp 

回 Serverudphp 


这 是 一 个 名 为 Zend_View_Helper_FormText 的 类 的 定义 , 它 拥有 一 个 名 为 formText 的 公 
有 成 员 函 数 。 调 用 该 成 员 函 数 , 将 会 返回 一 段 XHTML 代码 ,很 明显 这 就 是 我 们 非常 熟悉 
的 “文本 输入 框 ? 表 单元 素 代码 。 这 个 文件 实际 上 就 是 formText 视图 助手 的 定义 。 


从 上 述 代码 可 以 看 出 ,Zend Framework 中 助手 的 定义 规则 如 下 : 

CD 类 的 前 级 采用 Zend View Helper (默认 助手 路 径 ) 形 式 , 类 名 的 最 后 一 部 分 是 助 
手 的 名 称 。 

(2) 类 应 当 且 至 少 有 一 个 以 助手 名 命名 的 方法 ,方法 名 采用 驼峰 格式 , 即 首 字母 小 写 ， 
之 后 的 每 个 单词 首 字母 大 写 ,方法 的 访问 权限 为 public。 

Zend. View 的 基本 视图 助手 大 部 分 都 是 用 来 生成 组 件 和 自动 转 义 变量 的 ,也 有 些 助手 
用 来 创建 基于 路 由 的 URL 和 HTML 列表 以 及 声明 变量 ,常用 的 助手 名 称 及 功能 见 表 10. 3。 


表 10.3 基本 视图 助手 


视图 助手 说 明 
declareVars() 声明 View 对 象 中 的 变量 
fieldset( $ name, $ content, $ attribs) 生成 一 个 XHTML fieldset 
form( $ name, $ attribs, $ content) 生成 一 个 XHTML 表单 
formButton( $ name, $ value, $ attribs) 生成 二 button /7 753€ 
formCheckbox( $ name, $ value, $ attribs, $ options) | 生成 二 input type="checkbox" /7 76€ 
formErrors( $ errors, $ options) 生成 一 个 无 顺序 的 XHTML 列表 来 显示 错误 
formFile( $ name, $ value, $ attribs) 生成 二 input type— "file" /7 763€ 
formHidden( $ name. $ value, $ attribs) 生成 二 input type="hidden" /二 元 素 
pp $ name, $ value, $ attribs, $ options, 生成 一 个 checkboxes 列表 
$ listsep) 
formPassword( $ name, $ value, $ attribs) 生成 二 input type="password" /二 元 素 
formRadio( $ name, $ value, $ attribs, $ options) 生成 一 系列 一 input type="button" /7 763€ 
formReset( $ name, $ value, $ attribs) 生成 一 input type— "reset" /7 3753€ 


生成 < select >... </select >, 其 中 的 每 个 


formSelect( $ name, $ value, $ attribs, $ options) option XE i —4 $ option 数组 元 素 


formSubmit( $ name, $ value, $ attribs) 生成 二 input type="submit" /二 元 素 
formText( $ name, $ value, $ attribs) 生成 一 input type="text" /之 元 素 
formTextarea( $ name, $ value, $ attribs) Æ< textarea>. . . </textarea> Jt% 


action( $ action, $ controller, $ module = null, array 


动作 视图 助手 ,执行 一 个 特定 的 控制 器 Action 
区 域 助手 ,用 来 在 它 自 己 的 变量 范围 内 解析 特定 


$ params 一 array()) 


partial 的 模板 
partialLoop 区 域 助手 ,允许 传递 可 迭代 数据 并 为 每 个 条 目 解析 
占 位 符 助手 ,在 视图 脚本 和 视图 实例 之 间 持久 化 
placeholder 
内 容 
Doctype 指定 HTML 或 XHTML 文档 类 型 
HeadLink 生成 二 link 二 元素 
ER< meta > T X, 提供 关于 HTML 文档 的 
HeadMeta 
meta 信息 
HeadStyle ^E — head 76 € Pf] HTML <style> 76€ 
HeadTitle AE — head 76 € P] HTML <title> mK 
表 中 列 出 的 大 部 分 基本 视图 助手 (如 Doctype, HeadTitle, partialLoop 等 ) 在 前 面 的 章 1 


节 中 已 经 使 用 过 ,这 里 不 再 袭 述 ,请 大 家 结合 Zend Framework 库 源 文件 及 手册 慢 慢 体会 。 章 
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10.5.2 自 定义 视图 助手 


Zend_View 组 件 的 基本 视图 助手 数量 是 有 限 的 ,并 且 功 能 比较 单一 ,在 项 目的 开发 过 
程 中 还 需要 创建 一 些 适合 自己 应 用 需求 的 视图 助手 类 .。 

A T EMX} Zend_View 中 基本 视图 助手 的 分 析 , 了 解 了 它们 的 基本 结构 后 ,编写 自 定 
义 的 助手 类 就 非常 容易 了 ,只 要 遵循 以 下 几 个 原则 即 可 : 

COD. 助手 类 的 类 名 的 最 后 部 分 必须 是 助手 的 名 称 , 并 使 用 驼峰 格式 。 

例如 要 定义 一 个 名 为 affairState 的 助手 类 ,类 名 的 最 后 部 分 应 为 AffairState, 前 组 为 
Zend View Helper ,所 以 ,类 的 全 名 应 为 Zend_View_Helper_ AffairState。 

(2) 类 中 必须 有 一 个 public 方法 ,该 方法 名 与 助手 类 名 相同 。 

该 方法 将 在 调用 $ this- affairState() 时 执行 。 在 (1) 中 的 例子 中 ,相应 的 方法 声明 应 
该 是 public function affairStateO 。 注 意 方 法 名 的 第 1 个 字母 为 小 写 。 

(3) 一 般 来 说 ,助手 类 不 应 该 有 echo, print 或 其 他 形式 的 输出 ,只 需要 返回 值 就 可 以 
了 ,并 且 返 回 的 数据 应 当 被 转 义 。 

(4) 类 文件 的 命名 应 该 是 助手 类 的 名 称 ,例如 在 (1) 中 的 例子 中 文件 要 存 为 
AffairState. php. 

(5) 将 助手 类 的 文件 放 在 application\views\helpers 目录 下 。 这 样 ,Zend_View 将 会 自 
动 加 载 .实例 化 ,持久 化 、 并 执行 视图 助手 。 


10.5.3 事务 信息 视图 的 优化 


1. 定义 视图 助手 类 

启动 Zend Studio 集成 开发 环境 ,选择 项 目 工 作 区 中 的 wmProject 项 目 , 在 application\ 
views\helpers 目录 上 右 击 鼠标 ,打开 新 建 PHP 文件 对 话 框 , 创 建 名 为 AffairState. php 的 
文件 ,并 添加 代码 : 


«?php 
class Zend View Helper AffairState 
{ 
public function affairState( $ state) 
{ 
switch ( $ state) { 
case 1: $ str = '[ 审 核 中 ...]';break; 
case 2: $ str = '[ 等 待 办 理 ...] '; break; 
case 3: $ str = '[ IETEZM E... ] '; break; 
case 4: $ str = '[ 已 经 完成 ]';break; 
default: $ str = ''; break; 
} 
return htmlspecialchars( $ str); 
) 
} 


2. 修改 视图 文件 代码 


<?php foreach ( $ this -> affairs as $affair):?^ 


< table style = "background:url(/images/date - bg2. gif) 
no- repeat left top;margin- top:5px"» 
<tr><td width= "60px" align = "center" 
<?php echo date( 'n', $ affair[ 'cdat'])?»H </td> 
< td style = "line - height :30px; border - bottom: 1px dashed # ff8800"> 
"标题 "<?php echo $ affair[ 'title']?> &nbsp;&nbsp;« font color = 'red'> 
<?php echo $ this -> AffairState( $ affair['state']) ?> 
</font></td></tr> 


在 视图 代码 中 ,可 以 调用 AffairState 助手 任意 次 。 它 只 被 实例 化 一 次 ,并 且 会 在 Zend_ 
View 实例 的 生命 周期 内 持久 存在 。 


10.6 本 章 小 结 


本 章 介 绍 系统 事务 信息 管理 功能 的 实现 ,包括 数据 库 的 设计 、 事 务 的 添加 、 事 务 的 分 类 
显示 、 事 务 提醒 ,批示 回复 以 及 事务 处 理 状态 跟踪 等 。 事 务 的 添加 采用 Zend Framework 的 
视图 助手 来 完成 ,这 是 一 种 Web 表单 处 理 的 新 的 解决 方案 。 

本 章 重点 掌握 办 公 自 动 化 管理 系统 中 的 事务 信息 管理 的 业务 逻辑 ,以 及 Zend Framework 
框架 的 视图 助手 的 概念 ,常用 助手 的 使 用 、 自 定义 助手 的 创建 规则 。 


事务 信息 管理 模块 


第 11 章 日 常 办 公 常 用 功能 模块 


办 公 自 动 化 管理 系统 在 企业 信息 管理 中 的 应 用 不 仅 规范 了 企业 的 行政 程序 ,而 且 大 大 
提高 了 办 公 效 率 , 使 企业 员工 的 工作 责任 感 、 紧 迫 感 得 到 了 进一步 增强 。 效 率 的 提高 意味 着 
员工 劳动 强度 的 增 大 工作 压力 的 增加 。 为 了 营造 一 个 快捷 、 高 效 、 轻 松 的 在 线 办 公 环 境 , 本 
系统 设置 了 一 些 常 用 的 辅助 办 公 功 能 。 例 如 ,为 员工 设置 个 人 网 络 存储 空间 、 人 允许 用 户 制订 
个 人 工作 日 程 与 撰写 个 人 工作 日 志 、 提 供 万 年 历 \、 提 供 通 讯 录 等 。 

本 章 实现 办 公 自 动 化 管理 系统 的 办 公 和 常用 功能 ,包括 网 络 U 盘 \ 日 程 信息 管理 ,日 历 查 
询 等 ,由 此 介绍 Zend Framework 的 Zend. Date 组 件 ,并 进一步 熟悉 Zend. View 视图 助手 、 
文件 上 传 及 其 他 组 件 的 使 用 。 


11.1 日 常 办 公 常 用 功能 效果 预览 


本 系统 实现 了 3 种 常用 的 在 线 办 公 功 能 , 即 用 户 网 络 空 间 、 用 户 日 程 信息 管理 及 日 历 查 
询 。“ 网 络 空间 ”模块 方便 用 户 资料 的 分 类 管理 与 传递 , 它 是 资源 共享 的 一 个 重要 方面 ;“ 日 
程 信息 管理 ”模块 允许 用 户 制订 个 人 工作 计划 、 撰 写 个 人 工作 日 志 , 以 增强 用 户 工作 中 的 条 
理性 与 归纳 性 ,从 而 提高 工作 质量 ;“ 日 历 查 询 ” 模 块 既 属 于 通用 查询 功能 ,同时 也 为 其 他 功 
能 模块 提供 服务 。 


11.1.1 用 户 网 络 空间 页 面 效果 


1. 网 络 空间 根 目 录 页 面 

图 11.1 所 示 的 是 系统 为 用 户 提供 的 网 络 空间 主页 面 效 果 。 在 线 办 公 系统 需要 给 每 一 
位 登录 用 户 提供 一 个 网 络 空间 ,空间 的 大 小 由 系统 管理 员 决定 。 它 可 以 由 系统 管理 员 统一 
设置 ,也 可 以 由 用 户 自 己 创建 ,本 系统 采用 的 是 用 户 自 定义 创建 的 方式 。 

用 户 登 录 后 ,选择 主 菜 单 中 的 “个 人 办 公 ?|* 网 络 存储 ?菜单 项 或 快捷 菜单 中 的 “我 的 办 
公 桌 ”1“ 网 络 U 盘 ” 菜 单项 均 可 进入 用 户 的 个 人 网 络 空间 。 如 果 是 第 1 次 进入 该 页 面 ,系统 
会 提示 用 户 创建 自己 的 网 络 空 间 根 目录 ,这 里 根 目录 的 名 字 固 定 为 用 户 姓名 。 

从 图 11. 1 所 示 的 页 面 效 果 可 以 看 出 ,用 户 网 络 空 间 界面 分 为 上 、 下 两 个 区 域 , 上 部 区 域 
为 操作 功能 区 ,包括 “向 上 一 级 ”“ 根 目录 ”“ 新 文件 夹 "“ 上 传 文件 ”"“ 剪 切 ”“ 粘 贴 " 和 “ 打 
包 下 载 ”7 种 操作 ; 下 部 区 域 为 目录 内 容 显示 区 ,以 列表 的 形式 输出 当前 目录 下 的 子 文件 夹 
及 文件 。 另 外 ,页 面 的 顶部 还 设 有 网 络 空间 大 小 及 使 用 容量 的 说 明 。 

2. 网 络 空间 子 目 录 页 面 

图 11. 2 所 示 为 用 户 单 击 子 文件 夹 后 的 页 面 效果 。 在 用 户 网 络 空间 的 显示 区 域 中 , 子 目 
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图 11.1 用 户 网 络 空间 根 目录 页 面 
录 名 及 文件 名 均 为 超级 链接 。 用 户 如 果 单 击 子 目录 名 , 则 进入 该 子 目 录 ; 如 果 单 击 文件 名 , 则 
会 打开 该 文件 或 进入 文件 的 下 载 页 面 。 内 容 显 示 区 的 表 头 是 用 户 网 络 空间 的 目录 层次 结构 。 
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图 11.2 用 户 网 络 空间 子 目录 页 面 
3. 新 建文 件 夹 页 面 


图 11. 3 所 示 为 用 户 单 击 操作 区 中 的 “新 建文 件 夹 ” 按 钮 后 的 页 面 效果 。 用 户 单 击 “ 新 建 


文件 夹 ” 按 钮 后 ,在 页 面 的 操作 区 与 显示 区 之 间 出 现 创建 文件 夹 表单 ,用 来 接收 用 户 输入 的 
新 文件 夹 的 名 字 。 


4. 上 传 文件 页 面 


图 11. 4 所 示 为 用 户 单 击 操作 区 中 的 “上 传 文件 ”按钮 后 的 页 面 效 果 。 用 户 单 击 * 上 传 文 
件 ” 按 钮 后 ,在 页 面 的 操作 区 与 显示 区 之 间 出 现 文 件 上 传 表单 ,方便 用 户 选 择 需要 上 传 的 文件 。 
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你 的 网 络 U 盘 容 蜂 是 100M 已 使 用 的 容 星 : 32.711 KB 
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11.3 新 建文 件 夹 页 面 
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11.4 上 传 文件 页 面 


11.1.2 用 户 日 程 信息 管理 页 面 效 果 


1. 日 程 信息 管理 主页 面 

图 11.5 所 示 为 用 户 日 程 信息 管理 主页 面 效果 。 用 户 登录 后 ,选择 主 菜单 中 的 “个 人 办 
公 ”|“ 个 人 日 程 "菜单 项 或 快捷 菜单 中 的 “我 的 办 公 桌 ”|“ 日 程 安排 "菜单 项 即 可 进入 用 户 的 
日 程 信息 管理 主页 面 。 

用 户 日 程 信息 管理 模块 借用 了 第 10 章 中 的 事务 信息 管理 视图 结构 , 它 的 导航 菜单 包含 
“今日 工作 ”“ 本 周 安排 “日 程 查询 与 “ 待 办 提醒 ?4 个 子 项 。 这 里 的 主页 面 也 是 “今日 工 
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作 ” 的 显示 页 面 。 
2. 本 周 安排 页 面 


图 11.6 所 示 为 用 户 本 周 工作 安排 页 面 效 果 , 在 主 显示 区 以 表格 的 形式 详细 列 出 了 本 星 
期 的 每 一 个 工作 日 需要 完成 的 工作 任务 。 


ET 
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11.6 用 户 本 周 安排 页 面 


3. 日 程 查 询 页 面 
图 11.7 所 示 为 用 户 日 程 查询 页 面 效果 ,这 里 以 电子 台历 的 表现 形式 完成 用 户 的 日 程 查询 


功能 ,符合 用 户 的 工作 与 生活 习惯 。 用 户 单 击 台历 中 的 某 一 天 , 即 可 了 解 该 日 的 工作 安排 详情 。 
4. 添加 事务 页 面 
图 11. 8 所 示 为 用 户 制订 日 程 时 添加 事务 的 页 面 效 果 , 表 单 中 设 有 “事务 类 型 "“ 标 题 ”、 
“内 容 ”“ 开 始 日 期 * 和 “提醒 日 期 ”5 种 表单 元 素 ,用 于 接受 用 户 的 输入 。 事 务 类 型 分 为 “个 
人 事务 ”“ 工 作 事务 ”; 事务 开始 日 期 为 某 项 安排 开始 实施 的 时 间 , 由 用 户 单 击 日 历 图 标 进 
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11.7 用 户 日 程 查询 页 面 


行 选择 ,如 图 11. 9 所 示 ; 事务 提醒 日 期 为 该 项 工作 安排 的 系统 提示 开始 时 间 ,为 了 简单 ,这 
里 固定 为 事务 开始 时 间 的 前 3 天 。 


日程 安排 : 添加 事务 
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11.8. 添加 事务 页 面 
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11.9. 设置 事务 开始 时 间 页 面 


11.2 数据 库 设 计 


本 章 主 要 实现 用 户 网 络 空间 与 日 程 信息 管理 的 功能 ,根据 第 3 章 的 总 体 设计 与 功能 模 
块 的 业务 逻辑 创建 “用 户 文件 夹 " “用户 文件 ”和 “用 户 日 程 ”3 张 数据 表 存 储 功能 实现 中 的 
数据 信息 。 


11.2.1 用 户 网 络 室 间 模块 数据 库 


创建 用 户 网 络 空间 功能 模块 数据 库 , 首 先 必 须 设 计 实现 该 功能 的 业务 流程 ,也 就 是 业务 
EE. ER 11. 1 所 示 的 页 面 中 ,大 家 看 到 了 一 个 类 似 “资源 管理 器 ”的 文件 系统 界面 , 它 具 
有 清晰 的 目录 层次 结构 。 然 而 ,这 里 呈现 的 目录 层次 结构 实际 上 是 虚拟 的 ,在 服务 器 上 并 不 
存在 这 么 多 的 子 文件 夹 ,所 有 用 户 上 传 文件 都 存放 在 一 个 以 用 户 名 命名 的 文件 夹 中 ,如 
图 11. 10 所 示 。 该 图 中 的 “ 微 梦 "与 “ 微 梦 网 ”文件 夹 即 为 登录 用 户 网 络 空间 的 根 目录 。 子 文 
件 夹 的 层次 结构 以 及 “ 剪 切 “粘贴 ”等 操作 其 实 是 通过 数据 库 表 实现 的 。 当 然 , 大 家 也 可 以 
在 服务 器 上 创建 真实 的 子 目录 层次 结构 。 
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11.10 用 户 网 络 空间 目录 结构 


根据 本 系统 用 户 网 络 空间 的 创建 与 操作 业务 逻辑 ,在 数据 库 中 创建 “用 户 文 件 夹 "tb_ 
userfolder 以 及 “用 户 文件 ”tb_userfile 两 张 数据 表 。 

1. tb userfolder 数据 表 

打开 phpMyAdmin 数据 库 管 理工 具 , 在 db_wmoams 数据 库 中 新 建 名 为 tb_userfolder 
的 数据 表 , 其 字段 含义 见 表 11. 1。 字 段 属 性 如 图 11.11 所 示 。 


表 11.1 tb userfolder 数据 表 的 字段 说 阴 


字段 名 说 明 
id 自 增 变 量 ,主键 ,目录 的 唯一 标识 
foldername 文件 夹 名 称 
fid 文件 夹 父 目录 ID, 根 目录 为 0 
layerid 目录 层次 , 根 目录 为 1 
uid 目录 创建 人 ID ,对 应 tb. user 表 的 id 字段 
cdat 目录 创建 时 间 
share 是 否 共享 ,0 为 非 共享 、1 为 共享 
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id bigint(20) 否 天 AUTO_INCREMENT 
foldername varchar(20) gbk chinese ci 8 

fid bigint(20) 否 0 

layerid tinyint(6) 否 0 

uid int(11) zo 

cdat int(11) 否 0 

share tinyint(1) zo 


11.11 tb userfolder 数据 表 的 字段 属性 


文件 夹 数据 表 tb_userfolder 设 有 7 个 字段 ,其 中 fid 表示 当前 目录 的 上 一 级 父 目 录 ID. 
它 的 值 应 为 本 数据 表 中 字段 id 存储 的 数据 ,用 户 网 络 空间 根 目录 的 fid 为 0; 字段 layerid 
表示 当前 目录 的 层次 ,用 于 “向 上 一 级 "操作 功能 的 实现 。 用 户 每 单 击 一 次 “向 上 一 级 ”操作 
按钮 ,layerid 在 当前 值 基础 上 减 1, 直 到 它 的 值 变 为 1, 即 达到 用 户 网 络 空间 根 目录 为 止 。 
表 中 的 share 字段 用 来 设置 目录 的 共享 属性 。 

2. tb_userfile 数据 表 

打开 phpMyAdmin 数据 库 管理 工具 ,在 db_wmoams 数据 库 中 新 建 名 为 tb_userfile 的 
数据 表 ,其 字段 含义 见 表 11.2。 字 段 属 性 如 图 11.12 所 示 。 


表 11.2 tb_userfile 数据 表 的 字段 说 明 


字 段 名 说 8 
id 自 增 变量 ,主键 ,文件 的 唯一 标识 
filename 文件 名 称 
folderid 文件 所 属 文件 夹 ID, 对 应 tb_userfolder 表 的 id 字段 
userid 文件 创建 人 ID, 对 应 tb. user 表 的 id 字段 
Size 文件 大 小 
extend 文件 扩展 名 
cdat 文件 创建 时 间 
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id bigint(20) € Æ — AUTO INCREMENT 
filename varchar(100) gbk chinese ci Ej 

folderid  int(11) 否 0 

userid — int(11) mo 

size —— im(11) 否 无 

extend varchar(6) utf8_general_ci 5 

cdat — in(1) mo 


图 11.12 tb userfile 数据 表 的 字段 属性 


文件 数据 表 tb_userfile 也 设 有 7 个 字段 ,其 中 folderid 表示 文件 所 属 目录 ID, 它 对 应 
tb_userfolder 数据 表 中 的 id 字段 ; size 表示 文件 大 小 ,单位 为 bit, 用 于 计算 用 户 网 络 空间 
的 使 用 情况 ; extend 表示 文件 扩展 名 ,用 于 文件 显示 时 图 标 类 型 的 确定 。 在 如 图 11. 2 所 示 
的 页 面 中 ,文件 名 称 前 面 都 带 有 一 个 表示 文件 类 型 的 图 标 ,这 些 图 片 的 文件 名 是 用 相应 的 文 
件 扩展 名 来 命名 的 。 例 如 ,Microsoft Word 文件 的 图 标 名 称 为 doc. gif. 


11.2.2 用 户 日 程 信息 管理 模块 数据 库 


用 户 日 程 信息 管理 功能 的 实现 过 程 与 第 10 章 介 绍 的 事务 信息 管理 模块 基本 相同 ,主要 
是 日 程 的 添加 与 事务 的 分 类 显示 。 不 同 的 是 ,用 户 日 程 信息 管理 模块 中 设 有 “ 待 办 提醒 ” 功 
能 ,所 以 在 数据 库 中 必须 为 每 项 安排 设置 系统 提醒 的 开始 时 间 。 

打开 phpMyAdmin 数据 库 管 理工 具 , 在 db_wmoams 数据 库 中 新 建 名 为 tb_schedule 
的 数据 表 , 其 字段 含义 见 表 11. 3。 字 段 属性 如 图 11. 13 所 示 。 


3 11.3 tb schedule 数据 表 的 字段 说 明 


字 段 名 说 8 
id 自 增 变量 ,主键 ,日 程 事务 的 唯一 标识 
uid 日 程 创建 人 ID, 对 应 tb_user 表 的 id 字段 
title 日 程 事务 标题 
content 日 程 事务 内 容 
cdat 日 程 事务 创建 时 间 
bdat 日 程 事务 实施 时 间 
rdat 日 程 事务 系统 提醒 开始 时 间 
typeid 日 程 事务 类 型 
State 日 程 事务 处 理 状态 
名 字 am 排序 规则 属性 2 默认 S 
id int(11) Æ 无 AUTO INCREMENT 
uid  tinyint(4) 否 0 
title ^ varcha(80) gbk_chinese_ci z 
content varchar(250) gbk_chinese_ci Ei 
edat — int(11) UNSIGNED 否 无 
bdat — int(11) Sx 
rdat — ini(11) sx 
typeid | tinyint(4) $0 
state — tinyint(4) $0 


图 11.13. tb schedule 数据 表 的 字段 属性 


日 程 信息 数据 表 tb_schedule 设 有 9 个 字段 ,与 事务 数据 表 tb_affair 基本 相似 。 其 中 
的 typeid 表示 日 程 事 务 的 类 型 ,这 里 仅 设 * 工 作 事 务 * 与 “个 人 事务 ”两 种 类 型 state 表示 日 
程 事务 的 处 理 进 度 。 


11.3 用户 网 络 空间 功能 模块 
通过 上 面 两 节 的 学 习 , 我 们 熟悉 了 用 户 网 络 空间 功能 模块 的 框架 结构 .业务 处 理 逻 辑 ， 
并 且 完 成 了 数据 库 的 设计 ,下 面 编码 实现 模块 功能 。 
11.3.1 控制 器 及 方法 的 创建 


为 了 让 用 户 拥有 自己 的 网 络 空间 ,并 能 在 空间 中 进行 文件 夹 及 文件 的 相关 操作 ,需要 设 
置 相应 的 控制 器 及 方法 ,控制 器 及 方法 的 创建 还 是 采用 Zend Studio 集成 开发 环境 提供 的 
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Zend Framework 工具 来 完成 。 

1. 创建 控制 器 及 方法 

启动 Zend Studio 集成 开发 环境 ,选择 项 目 工 作 区 中 的 wmProject 项 目 ,然后 选择 
Project 主 菜单 中 的 Zend Tool 菜单 项 ,打开 ZF Tool 工具 窗口 ,输入 命令 : 


zf create controller Netdisk 


在 默认 模块 default 中 创建 网 络 空间 信息 管理 控制 器 Netdisk。 然 后 用 同样 的 方法 打开 ZF 
Tool 工具 窗口 ,分 别 输入 命令 : 
zf create action create Netdisk 


zf create action addfolder Netdisk 
zf create action list Netdisk 


在 控制 器 Netdisk 中 创建 create, addfolder 和 list 3 个 方法 。create 方法 用 来 创建 用 户 网 络 
空间 ; addfolder 方法 用 来 创建 新 的 文件 夹 ; list 方法 负责 数据 的 显示 。 

2. 初始 化 控制 器 

利用 Zend Framework 的 命令 工具 生成 控制 器 及 方法 的 框架 代码 后 ,需要 在 框架 文件 
中 编写 自己 的 业务 逻辑 代码 。 为 了 编程 方便 ,在 Netdisk 控制 器 中 定义 user, ufolder, ufile 
3 个 对 象 ,分 别 表 示 登 录用 户 、 目 录 模 型 \ 文 件 模 型 ,并 在 init 方法 中 对 其 初始 化 。 代 码 
如 下 : 


class NetdiskController extends Zend Controller Action 
{ 
protected $ ufolder = null; 
protected $ ufile- null; 
protected $ user- null; 
public function init() 
( 
$ auth- Zend Registry: :get('auth'); 
if( $ auth - > hasIdentity())í 
$this-» user- $ auth; 
) 
$ this-» ufolder- new Wm Model Ufolder(); 
$this-» ufile- new Wm Model Ufile(); 


) 


对 于 对 象 的 访问 权限 ,这 里 使 用 的 是 pretected, 也 可 以 使 用 private 的 私有 访问 方式 。 
代码 中 的 Wm_Model_Ufolder 与 Wm_Model_Ufile 为 11. 2 节 中 创建 的 tb_userfolder tb_ 
userfile 数据 表 的 表 模 型 ,我 们 将 在 接 下 来 的 小 节 中 创建 它们 。 用 户 信息 从 用 户 认证 信息 对 
象 auth 中 提取 得 到 。 


11.3.2 数据 表 模 型 及 方法 的 设计 


在 上 面 的 控制 器 类 文件 中 创建 了 “文件 夹 表 ”模型 对 象 _ufolder 和 “文件 表 ” 模 型 对 象 
_ufile, 并 在 初始 化 方法 中 对 其 进行 了 初始 化 。 通 过 这 两 个 对 象 可 以 对 "文件 夹 表 ”和 ”文件 


表 ” 实 施 增 \ 删改. 查 等 各 种 操作 。 
1. 创建 模型 
打开 Zend Studio 集成 开发 环境 中 的 ZF Tool 工具 窗口 ,分 别 输入 命令 : 


zf create model Ufolder 
和 


zf create model Ufile 


创建 Wm Model Ufolder 与 Wm Model Ufile 模型 类 。 为 类 添加 基 类 及 对 应 的 数据 表 名 ， 
代码 如 下 : 


class Wm Model Ufolder extends Zend Db Table 
{ 


protected $ name- 'tb userfolder'; 


} 


class Wm Model Ufile extends Zend Db Table 
{ 


protected $ name- 'tb userfile'; 


} 


2. 添加 方法 
打开 模型 文件 application\models\Ufolder. php ,为 表 模 型 类 Wm_Model_Ufolder 添加 
createDisk 方法 ,getUfolder 方法 及 getUfolders 方法 ,代码 如 下 : 


public function createDisk( $ data = array()) 
{ 
$ row= $ this - » createRow(); 
if (count( $ data) » 0)( 
foreach ( $ data as $ key - » $ value)( 
$ row-»$ key -7 $ value; 
) 
$ row- > save() ; 
return $ row—> id; 


) 
else( 

throw new Zend_Exception( ' 申 请 网 络 U f A Wer); 
) 


} 


public function getUfolder( $ where) 
{ 
if (is numeric( $ where)){ 
$ row= $ this - » find( $ where) -> current(); 
) 第 
if (is array( $ where))( 11 
$ select = $ this- » select(); * 
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if (count( $ where) » 0)( 
foreach ( $ where as $ key 7» $ value)( 
$ select -> where( $ key." = ?", $ value); 
) 
) 
$ row- $ this- » fetchRow( $ select); 
) 
if ($ row)( 
return $ row; 
} 
else( 
return null; 
) 
) 


public function getUfolders( $ where = array(), $ order = null) 
{ 
$ select = $ this -> select(); 
if (count( $ where) > 0){ 
foreach ( $ where as $ key => $ value){ 
$ select - » where( $ key. '=?', $ value); 
} 
} 
if ( $ order) { 
$ select - » order( $ order); 
) 
$ result = $ this 一 > fetchAll( $ select); 
if ( $ result)( 
return $ result; 


) 
else( 

return null; 
j 


} 


上 述 代 码 与 前 面 几 章 中 模型 方法 的 代码 相似 ,非常 容易 理解 。createDisk 方法 用 来 创 
建 用 户 的 网 络 空间 ,并 返回 新 空间 根 目录 的 ID; getUfolder 方法 调用 fetchRow 函数 获取 单 
个 文件 夹 信息 ,返回 结果 为 Zend Db. Table Row. Abstract 对 象 ; getUfolders 方法 调用 
fetchAll 函数 获取 某 一 类 文件 夹 信息 ,返回 结果 为 Zend Db Table Rowset Abstract 对 象 。 
模型 方法 调用 后 的 返回 值 类 型 关系 到 数据 在 视图 中 的 显示 方法 。 
完成 Wm Model Ufolder 表 模 型 的 设计 后 , 接 下 来 为 表 模 型 Wm_Model_Ufile 添加 
addFile 和 getUfiles 方法 ,代码 如 下 : 
public function addFile( $ data - array()) 
{ 
$ row- $this-»createRow(); 
if (count( $ data) > 0){ 
foreach ( $ data as $ key - » $ value)( 
$ row-»$ key - $ value; 


} 


$ row - » save(); 
return $ row- id; 


) 
else( 

throw new Zend Exception( ' 添 加 文件 失败 !'); 
} 


public function getUfiles( $ where = array(), $ order = null) 


{ 


) 


$ select = $ this- » select(); 
iE (count( $ where) »- 0)( 


) 


foreach ( $ where as $ key => $ value)( 
$ select -> where( $ key. ' = ?', $ value); 


) 


if ( $ order)( 


) 


$ select - > order( $ order); 


$ result = $ this -> fetchAll( $ select); 
if ($ result)( 


) 


return $ result; 


else( 


) 


return null; 


11.3.3 自 定义 视图 助手 


在 如 图 11. 1 所 示 的 用 户 网 络 空间 页 面 中 需要 输出 空间 的 使 用 情况 以 及 当前 目录 的 层 
次 结构 ,我 们 用 自 定义 的 视图 助手 来 完成 这 两 项 功能 。 

1. NetDiskSize 视图 助手 

启动 Zend Studio 集成 开发 环境 ,选择 wmPoject 目录 下 的 application\ views\ helpers 
文件 夹 ,然后 右 击 该 文件 夹 , 通 过 快捷 菜单 打开 新 建 PHP 文件 对 话 框 ,创建 名 为 NetDiskSize. 
php 的 文件 ,并 添加 代码 : 


class Zend View Helper NetDiskSize 


{ 


public function netDiskSize() 


{ 


$ auth = Zend Registry::get('auth'); 
$ userId= $ auth- » getIdentity() 一 > id; 
$ modelFile = new Wm Model Ufile(); 
$ files = $ modelFile- > getUfiles(array( 'userid' => $ userId)); 
$ sizes = 0; 
foreach ( $ files as $ file){ 
$ sizes += $ file[ 'size']; 


} 
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return $ sizes; 
) 

) 

根据 第 10 章 中 介绍 的 视图 助手 类 的 定义 规则 ,该 视图 助手 类 的 类 名 为 NetDiskSize. 5 
文件 名 保持 一 致 ; 其 前 级 采用 默认 形式 Zend. View. Helper. ,类 中 有 一 个 与 类 名 相同 的 
public 方法 。 

该 视图 助手 用 来 返回 用 户 网 络 空间 的 容量 使 用 情况 。 程 序 首先 获取 注册 表 中 的 用 户 认 
证 对 象 ,提取 当前 用 户 的 ID ,然后 调用 数据 表 tb_userfile 的 模型 方法 getUfiles ,得 到 属于 当 
前 用 户 的 全 部 文件 ,最 后 遍历 所 有 文件 对 象 , 将 文件 大 小 相 加 , 即 可 得 到 当前 用 户 的 网 络 空 
间 已 使 用 的 容量 值 。 

2. FolderPosition 视图 助手 

使 用 上 面 的 方法 在 helpers 文件 夹 中 添加 新 文件 FolderPosition. php, 并 在 文件 中 添加 
如 下 代码 : 


class Zend View Helper FolderPosition 


{ 
public function folderPosition( $ foldeId) 


{ 
$ modelFolder = new Wm Model Ufolder(); 
$ fatherFolder = $ modelFolder -> getUfolder( $ foldeId); 
$ fid= $ fatherFolder[ 'fid']; 
$ str = $ fatherFolder[ 'foldername']; 
if ($ fid){ 
while ( $ fid){ 
$ fatherFolder = $ modelFolder -> getUfolder( $ fid); 
$ str = $ fatherFolder[ 'foldername']. '&gt;&gt; '. $ str; 
$ fid= $ fatherFolder[ 'fid']; 
} 
} 
return $ str; 
} 
) 


该 视图 助手 用 来 输出 用 户 网 络 空间 当前 目录 的 层次 结构 字符 串 , 如 图 11.3 所 示 。 程 序 
首先 通过 当前 文件 夹 的 ID 调用 Wm_Model_Ufolder 模型 的 getUfolder 方法 ,得 到 当前 目 
录 名 称 及 其 父 目 录 ID. BI fid; 然后 递归 检测 父 目 录 的 fid. TESI fid 等 于 0, 即 用 户 网 络 空间 
的 根 目录 为 止 。 


11.3.4 创建 用 户 网络 室 间 


在 前 面 已 经 说 过 ,本 系统 的 用 户 网 络 空间 需要 用 户 申请 。 因 此 ,用 户 第 1 次 进入 网 络 空 
间 信 息 管理 模块 时 ,出 现 的 页 面 界面 并 不 是 如 图 11. 1 所 示 的 效果 ,而 是 如 图 11. 14 所 示 的 
结构 。 页 面 中 设置 的 * 单 击 这 里 开通 网 络 U 盘 ? 超 级 链接 ,就 是 用 于 网 络 空间 创建 的 。 除 此 
之 外 :页 面 中 还 有 当前 用 户 可 以 申请 的 网 络 空间 大 小 的 说 明 。 

图 11. 13 所 示 的 页 面 为 Netdisk 控制 器 的 index. phtml 视图 效果 之 一 ,下 面 在 index 方 
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图 11.14 用 户 开通 网 络 空间 页 面 


法 及 其 视图 文件 中 添加 代码 。 
1. 编写 index 方法 代码 
打开 Netdisk 控制 器 文件 application\controllers\ NetdiskController. php, Æ H index 
方法 中 添加 如 下 代码 : 
public function indexAction() 
{ 
$ userid= $ this->_user -> getIdentity()—> id; 
$ where = array( 'uid' => $ userid, 'fid' => 0); 
$ isfolder = $ this- » ufolder- > getUfolder( $ where); 
if( $ isfolder -- null)( 
$ this - » render(); 
}else{ 
$ rootfolder = $ isfolder -> toArray(); 
$ this - » redirect ( '/netdisk/list/folderid/'. $ rootfolder[ 'id']); 


) 


程序 首先 从 控制 器 对 象 user 中 获取 当前 用 户 ID, 然 后 查找 用 户 网 络 空间 根 目 录 。 如 果 
根 目 录 存 在 , 则 跳 转 到 list 方法 进入 用 户 网 络 空间 ; 否则 说 明 用 户 还 未 申请 网 络 空间 ,页面 
转向 图 11. 13 所 示 的 界面 ,提醒 用 户 开通 自己 的 网 络 空间 。 

2. 编写 index 方法 视图 代码 

打开 application\views\scripts\netdisk\index. phtml 视图 文件 ,添加 如 下 代码 : 


<?php require once 'netdiskcss.php';?> 


<div id= "dtitle" align = "center"> 用 户 网 络 U0U 盘 </div> 第 
< table width = "90 % " border = "0" cellpadding = "0" cellspacing = "0"> 11 
<tr><td> * 
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< table width = "100€" border = 0 align = center cellPadding = 2 cellSpacing = 1 class = 

tableborder > 
< tbody» < tr» < td class = tablerow align = left > 
您 还 没有 自己 的 网 络 0 盘 , 请 单 击 下 面 的 链接 申请 ! 您 的 网 络 0 盘 的 最 大 容量 为 100MB 
</td></tr ></tbody> 

</table> 

</td></tr><tr><td> 

< table cellPadding = "2" cellSpacing = 1 class = tableborder > 

< tbody id = tbodyl >< tr >< td valign = "middle"> 

<a href = "/netdisk/create"><b> 单 击 这 里 开通 网 络 U 盘 </b></a> 

</td></tr></tbody></table> 

</table> 


为 了 简单 ,这 里 分 配给 每 个 用 户 的 网 络 空间 均 为 100MB, 在 实际 应 用 中 该 项 指标 应 根 
据 用 户 角色 或 权限 指定 ,并 设置 相应 的 开通 、 锁 定 及 删除 等 管理 功能 。 代 码 中 的 阴影 部 分 为 
用 户 申请 网 络 空间 超级 链接 。 

3. 编写 create 方法 代码 

从 上 面 的 index. phtml 视图 代码 中 可 以 看 到 , 当 用 户 单 击 “开通 网 络 U 盘 ? 超 级 链接 
后 ,程序 跳 转 到 Netdisk 控制 器 的 create 方法 ,下 面 是 该 方法 的 代码 : 


public function createAction() 
{ 
$ userid= $ this- >_user -> getIdentity() -> id; 
$ username = $ this -» user -> getIdentity() -> username; 
$ data = array( 'foldername' = > $ username. '(U f A Ho&) ', 
"layerid' 2» 1, 
'fid' 2» 0, 
'uid' => $ userid, 
'cdat' => time() 
) 
$ folder = $ this- » ufolder -> createDisk( $ data); 
$ this -> redirect( '/netdisk/list/folderid/'. $ folder); 
H 


程序 首先 获取 当前 用 户 的 ID 及 姓名 ,然后 确定 根 目 录 的 名 称 、 层 级 、 父 目录 创建 人 及 
创建 日 期 ,并 把 它们 赋 与 data 数组 ,最 后 调用 Wm_Model_Ufolder 表 模 型 的 createDisk 方 
法 将 根 目录 数据 写 和 人 到 tb_userfolder 数据 表 中 ,完成 用 户 网 络 空间 的 创建 。 


11.3.5 显示 用 户 网 络 空间 


用 户 网 络 空间 的 显示 功能 由 Netdisk 控制 器 的 list 方法 完成 。 用 户 网 络 空间 的 显示 请 
求 可 能 来 自主 菜单 .快捷 菜单 “向 上 一 级 ”按钮 “ 根 目录 ”按钮 以 及 子 文件 夹 名 称 等 超级 链 
接 , 这 些 请 求 中 所 传递 的 参数 往往 是 不 同 的 ,所 以 在 list 方法 中 要 考虑 各 种 请 求 的 参数 传递 
形式 。 

1. 编写 list 方法 代码 

打开 Netdisk 控制 器 文件 application\controllers\ NetdiskController. php ,在 方法 list 
中 添加 如 下 代码 : 


public function listAction() 
{ 
// 当 前 文件 夹 
$ folderid- $ this -> getRequest() —> getParan( 'folderid'); 
if(!isset( $ folderid))( 
$ userid= $ this- » user-» getIdentity() -> id; 
$ username = $ this- » user -> getIdentity() -> username; 
$ where = array( 'uid' => $ userid, 'fid' => 0); 
$ pfolder = $ this ->_ufolder -> getUfolder( $ where) -> toArray(); 
$ rootfolderid- $ pfolder['id']; 
$ folderid= $ pfolder[ 'id']; 


}else{ 
$ pfolder = $ this- » ufolder -> find( $ folderid) -> current(); 
} 
// 当 前 文件 夹 的 子 文件 夹 
$ folders = $ this -» ufolder- » getUfolders(array( 'fid' = > $ folderid)); 
// 当 前 文件 夹 中 的 文件 


$files- $ this- » ufile-»getUfiles(array( 'folderid'- » $ folderid)); 
$ this -> view- » folders = $ folders; 
$ this- >view-> files = $ files; 
$ this -> view - > pfolder = $ pfolder; 
} 


用 户 网 络 空间 的 显示 一 定 是 针对 空间 根 目 录 或 某 个 子 目 录 的 ,所 以 ,list 方法 的 首要 任 
务 就 是 要 获取 显示 目录 的 id。 如果 请 求 中 没有 传递 需要 显示 的 文件 夹 的 id, 则 默认 显示 用 
户 空 间 的 根 目录 ,上 述 代码 中 的 ife else 结构 就 是 实现 这 个 功能 的 。 得 到 目录 的 id 后 ,就 可 
以 调用 模型 方法 .查询 该 目录 下 的 子 文件 夹 及 文件 ,最 后 将 查询 结果 传递 到 视图 中 。 

2. 编写 list 方法 视图 代码 

打开 application\views\scripts\netdisk\list. phtml 视图 文件 ,添加 如 下 代码 : 


<?php require once 'netdiskcss. php';?> 
<div id= "dtitle" align = "center"> 用 户 网 络 U 盘 </div> 
< table width = "100%" border = "0" cellpadding = "0" cellspacing = "0" align = center > 
<tr><td valign= "top"> 
<table cellPadding = 2 cellSpacing=1 width="100%" border = "1"> 
<tbody><tr><td height = 24 valign = middle><b> 
你 的 网 络 0 盘 容量 是 100MB, 已 使 用 的 容量 : 
<?php echo $ this—> netDiskSize()/1000.0;?» &nbsp;KB 
</b></td></tr »«/tbody »«/table»«/td»«/tr» 


<tr><td> 
< script type = "text/javascript"> 
var aID7 0; 
function ShowTabsl(ID){ 
if(ID!- aID)( 
Tabsl[aID]. style. display = "none"; 
Tabs1[ ID]. style. display = ""; 
aID= ID; 
} 
} 
</script> 


PHP Zend Framework 项 卓 开 发 其 矶 全 铀 教程 


< table width = "500" height = "62" border = "0" cellPadding = 2 
cellSpacing- 1 class = tableborder > 
<tr> 
<td width - "60" align= "center" valign="middle" height = "40"> 
<a href = "/netdisk/list <?php echo 
$ this -> pfolder[ 'fid'] !=0 ? '/folderid/'. $ this -> pfolder[ 'fid'] : '/'7>"> 
< ing src = "/images/up. gif" alt = "上 一 级 "width= "32" height = "32" 
align = "absmiddle" border = 0 /></a ></td> 
« td width = "60" align= "center" valign= "middle"> 
<a href = "/netdisk/list"> 
< ing src = "/images/home. gif" alt = " 根 目录 " border = 0 /></a></td> 
« td width = "60" align = "center" valign = "middle"> 
«a href =" €" onclick = "ShowTabsl(1)"> 
< img src = "/images/new_folder. gif"border = 0 /></a></td> 
<td width= "60" align="center" valign= "middle"> 
<a href ="#" Ž onclick = "ShowTabs1(2)"> 
< img src = "/images/upload. gif" alt = " [- f£" border = 0 /></a></td> 
<td width= "60" align= "center" valign = "middle"><a href="#"> 
< img src = "/images/bcut.gif" alt = " 剪 切 "border = 0 /></a></td> 
<td width="60" align= "center" valign = "middle"><a href="#"> 
< img src = "/images/paste. gif" alt = "粘贴 " border = 0 /></a></td> 
<td width="60" align= "center" valign= "middle"><a href =" #" > 
< ing src = "/images/bzip. jpg" alt = "打包 下 载 " /></a></td> 
< td width = "150" rowspan = "2"></td> 
</tr> 
<tr> 
< td height = "22" align = "center" width = "60"> 向 上 一 级 </td> 
< td align = "center" valign= "middle" width = "60"> 根 目录 </td> 
< td align = "center" vali "middle" width = "60"> 新 文件 夹 </td> 
<td align = "center" valign = "middle" width= "60"> 上 传 文件 </td> 
< td align = "center" valign= "middle" width = "60"> 剪 切 </td> 
< td align = "center" valign= "middle" width = "60"> 粘 贴 </td> 
« td align = "center" valign= "middle" width = "60"> 打 包 下 载 </td> 
</tr> 
</table> 
</td></tr> 
<tr><td> 
< table width = "100 % " border = "0" cellpadding = "0" cellspacing = "0"> 
< tbody style = "display:block" id = "Tabsi"» 
<tr><td height = "20"»« div id= "msg"»«/div» </td></tr> 
</tbody> 
< tbody style = "display:none" id= "Tabsl"> 
<tr> 
< td height = "20" > 文件 夹 名 称 : 
< form method = "post" action = "/netdisk/addfolder" > 
< input type = "text" name = "foldername" size = 20 /> 
< input type = "hidden" name = "folderid" 
value = "<?php echo $ this -> pfolder[ 'id'] ?>" /> 
< input type = "hidden" name = "layerid" 
value = "<?php echo $ this -> pfolder[ 'layerid'] ?>" /> 
< input type = "submit" value = "创建 文件 夹 ” /> 
</form> 


</td> 
</tr> 
</tbody> 
< tbody style = "display:none" id= "Tabsl"> 
<tr> 
< td height = "20" > 文件 上 传 :</td></tr> 
<?php echo $ this -> action( upload', 'common', null, 
array( 'folderId' => $ this -> pfolder[ 'id']))?» 
</tbody> 
«/table»«/td»«/tr» 
<tr><td> 当 前 目录 : 
<?php echo $ this -> folderPosition( $ this -> pfolder[ 'id']) ?> 
</td></tr> 
<tr><td> 
< table cellPadding = 2 cellSpacing = 1 width = "500" class = tableborder > 
<tr> 
<td width = "5 $ "> 选中 </td> 
<td width= "35 $ "> 名 称 </td> 
«td width = "10 $ "> 大 小 </td> 
« td width = "30 s "> 更 新 时 间 </td> 
« td width = "20 $ "> 操作 </td> 
</tr> 
< tbody id = tbody1 > 
<?php foreach ( $ this -> folders as $ folder) :?> 
«tr bgcolor = "i F8F8F8" >< td» 
< input type = checkbox name = checkfolder id = checkfolder value = "" > 
</td>< td> 
< img src = "/images/folder.gif" border = 0 alt = "文件 夹 "> 
<a href = "/netdisk/list/folderid/<?php echo $ folder[ 'id']?>"> 
<?php echo $ folder[ 'foldername']?> 
</a></td> 
<td>-</td> 
« td» «?php echo date('Y- m- dH:i:s', $ folder['cdat'])?></td> 
<td><a href =" £" >< img src = "/images/del. gif" border = 0 alt = "删除 " ></a><a href = 
"#" >< img src= "/images/cut.gif" border = 0 alt = "Bj ]" ></a> </td> 
«tr» 
<?php endforeach; ?» 
</tbody> 
< form name = "form3" method = "post" action = "/netdisk/list" > 
< input type = hidden name = checkLines > 
< tbody id = tbody2 > 
<?php if(count( $ this -> files) ) :?> 
<?php foreach ( $ this -> files as $ file) :?> 
< tr bgcolor = " # F8F8F8" id = file> 
< td>< input type = checkbox name = checkLine id = checkLine ></td> 
<td>< img src = "/images/img_file/ 
<?php echo $ file['extend']?».gif" border=0 alt= "文件 > 
<a href = " # "><?php echo $ file[ 'filename']?></a ></td> 
<td><?php echo $ file['size'];?»«/td» 
<td><?php echo date('Y- m- d H:i:s', $ file['cdat']);?»«/td» 
<td><a href =" #" >< ing src = "/images/del.gif" border = 0 ></a> 
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<a href = # >< img src = /images/cut.gif border = 0 > 
</a> </td> 
</tr> 
<?php endforeach; ?» 
<?php endif;?> 
</tbody></form></table> </td></tr></table> 
上 述 视 图 代码 完成 如 图 11. 1 一 图 11. 4 所 示 的 页 面 效 果 。 虽 然 代 码 比较 长 ,但 大 部 分 都 是 
HTML 的 页 面 布 局 元 素 ,在 学 习 过 程 中 请 大 家 特别 注意 阴影 部 分 代码 的 作用 。 说 明 如 下 : 
1) 用 户 网 络 空 间 使 用 大 小 
代码 如 下 : 


<?php echo $ this -> netDiskSize()/1000.0;?> &nbsp;KB 


使 用 自 定 义 的 NetDiskSize 视图 助手 获得 用 户 网 络 空间 的 使 用 情况 ,并 将 空间 大 小 单 
位 转化 成 KB。 

2) 用 户 网 络 空间 目录 层次 结构 

代码 如 下 : 


<?php echo $ this -> folderPosition( $ this -> pfolder[ 'id']) ?> 


使 用 自 定 义 的 FolderPosition 视图 助手 输出 当前 目录 的 层次 结构 。 

3) 文件 圭 传 

代码 如 下 : 

<?php echo $ this- > action( 'upload', 'common', null, array( 'folderId' => $ this -> pfolder[ 'id']))?> 
使 用 动作 助手 action 完成 文件 上 传 。 这 里 调用 了 Common 控制 器 的 upload 方法 ,这 个 控制 器 
是 我 们 自 定义 的 ,将 在 后 面 进 行 介绍 action 动作 助手 的 4 个 参数 分 别 表 示 控 制 器 方法 、 控 制 
器 ,模块 与 参数 ,上 面 的 代码 相当 于 /common/upload/folderld/ $ this— — pfolder( 'id"] 请 求 。 

4) 返回 上 一 级 目录 

代码 如 下 : 

<a href = "/netdisk/list <?php echo 

$ this -> pfolder[ 'fid'] !=0 ? '/folderid/'. $ this -> pfolder[ 'fid'] : '/'?»"» 
使 用 条 件 请 句 通过 当前 目录 的 fid 值 确定 转向 的 页 面 , 根 目录 的 fid 为 0。 

5) 子 文件 夹 的 显示 

代码 如 下 : 


<?php foreach ( $ this -> folders as $ folder) :?> 


<?php endforeach;?> 


使 用 循环 完成 子 目 录 的 显示 ,注意 遍历 过 程 中 文件 夹 名 称 的 获取 与 链接 的 设置 。 
6) 文件 的 显示 
代码 如 下 : 


<?php if(count( $ this -> files) ) :?> 


<?php foreach ( $ this -> files as $ file) :?> 
< img src = "/images/img file/«?php echo $ file['extend']?».gif" /> 


m endforeach;?» 

<?php endif;?» 
使 用 循环 完成 目录 中 文件 的 显示 ,注意 遍历 过 程 中 文件 名 称 的 获取 与 文件 图 标的 sre 属性 
设置 。 


11.3.6 新 建文 件 志 与 上 传 文件 


图 11. 1 所 示 的 页 面 操 作 区 域 中 显示 了 7 种 功能 按钮 ,在 list. pthml 视图 中 已 经 实现 了 
“上 一 级 目录 ”与 “ 根 目录 ”功能 。 由 于 篇 幅 的 关系 ,在 剩 下 的 5 种 操作 中 这 里 只 介绍 “新 建文 
件 夹 ” 与 “文件 上 传 ”两 种 功能 的 实现 。 

1. 新 建文 件 夹 

当 用 户 单 击 视图 页 面 中 的 “新 文件 夹 ” 按 钮 后 ,页 面 中 出 现 新 建文 件 夹 表 单 ,该 表单 提交 
至 Netdisk 控制 器 的 addfolder 方法 上 。Netdisk 控制 器 的 addfolder 方法 代码 如 下 : 


public function addfolderAction() 

{ 
$ formData = $ this -> getRequest() - > getParams( ) ; 
$ folderid = $ formData[ 'folderid']; 


if (trim( $ formData[ 'foldername']) == '')( 
$ this -> redirect ( '/netdisk/list/folderid/'. $ folderid); 
exit(); 


) 
$ folder = $ this- » ufolder - > getUfolder( 
array( 'fid' => $ folderid, 'foldername' = > $ formData[ 'foldername'])); 
if( $ folder == null){ 
$ data = array( 'foldername' = > $ formData[ 'foldername'], 
'layerid' => $ formData[ 'layerid'] + 1, 
'fid'=>$ folderid, 
'uid' => $ this->_user -> getIdentity() -> id, 
'cdat' => time() 
) 
$ newFolder = $ this 一 >_ufolder 一 > createDisk( $ data); 
$ this - > redirect( '/netdisk/list/folderid/'. $ folderid); 


) 


程序 首先 获取 从 视图 中 传递 过 来 的 表单 参数 ,接着 进行 非 空 与 重 名 检验 。 如 果 文件 夹 
名 称 不 为 空 且 当前 目录 中 没有 与 输入 同名 的 子 目录 , 则 调用 Wm_Modele_Ufolder 模型 方 
法 createDisk 创建 新 的 子 文件 夹 。 

2. 上 传 文件 

当 用 户 单 击 视图 页 面 中 的 “上 传 文件 ?按钮 后 ,页 面 中 出 现 文件 上 传 表单 元 素 , 如 图 11. 4 
所 示 。 该 表单 是 一 个 Zend_Form 表单 对 象 ,由 Common 控制 器 的 upload 方法 视图 泻 染 得 
到 。 文 件 的 上 传 与 下 载 是 Web 应 用 中 的 常用 操作 ,许多 功能 模块 都 会 用 到 它 。 为 了 满足 这 
种 通用 性 的 要 求 ,我 们 将 它 放 在 一 个 专门 的 公共 控制 器 Common 中 ,该 控制 器 的 实现 与 第 8 
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办 公 自 动 化 管理 系统 最 大 的 优点 就 是 高 效 与 快捷 ,用 户 登录 系统 后 ,需要 能 在 最 短 的 时 
间 内 了 解 自己 的 工作 任务 及 其 轻重 缓急 。 由 此 ,本 系统 专门 设计 了 一 个 固定 框架 来 显示 用 
户 的 近期 工作 安排 与 未 完成 工作 内 容 , 以 免 用 户 因 遗忘 而 影响 工作 。 除 此 之 外 还 设计 了 一 
个 日 程 信息 管理 子 模块 ,包括 添加 事务 、 今 日 工作 、 本 周 安 排 \ 日 程 查询 与 待 办 提醒 5 项 功 
能 ,方便 用 户 的 查询 与 管理 。 系 统 日 程 信息 管理 界面 如 图 11. 5 所 示 。 


11.4.1 创建 控制 器 及 方法 


为 了 对 日 程 信息 进行 管理 ,需要 设置 相应 的 控制 器 及 方法 。 控 制 器 及 方法 的 创建 这 里 
还 是 采用 Zend Framework 提供 的 ZF Tool 工具 完成 。 

1. 创建 控制 器 及 方法 

启动 Zend Studio 集成 开发 环境 ,选择 项 目 工作 区 中 的 wmProject 项 目 , 然 后 选择 
Project 主 菜单 下 的 Zend Tool 菜单 项 ,打开 ZF Tool 工具 窗口 ,输入 命令 : 


zf create controller Schedule 


在 默认 模块 default 中 创建 网 络 空间 信息 管理 控制 器 Schedule。 然 后 用 同样 的 方法 打开 ZF 
Tool 工具 窗口 ,分 别 输入 命令 : 


zf create action add Schedule 

zf create action work Schedule 

zf create action arrange Schedule 
zf create action search Schedule 
zf create action remind Schedule 


在 控制 器 Schedule "P 8| £& add, work arrange, search 和 remind 5 个 方法 ,分 别 用 来 完成 添 
加 日 程 事务 .显示 今日 工作 .输出 本 周 安排 .日 程 查询 以 及 显示 待 办 事务 提醒 的 功能 。 

2. 初始 化 控制 器 

其 初始 工作 与 前 面 的 其 他 控制 器 相似 ,代码 如 下 : 


class ScheduleController extends Zend Controller Action 
{ 
protected $ _user = null; 
protected $ _schedule = null; 
public function init() 
{ 
$ auth = Zend Registry::get('auth'); 
if( $ auth- > hasIdentity())( 
$this-» user- $ auth; 
} 
$ this ->_schedule = new Wm Model Schedule(); 


11.4.2 设计 数据 表 模 型 及 方法 


为 数据 表 tb_schedule 创建 表 模型 类 ,并 添加 相应 的 方法 代码 ,操作 步骤 与 前 面相 同 , 下 
面 直接 给 出 源 代 码 : 


class Wm Model Schedule extends Zend Db Table 
f 
protected $ name- 'tb schedule'; 
public function getSchedules( $ where = array(), $ order = null) 
t 
$ select = $ this -> select(); 
if (count( $ where) > 0){ 
foreach ( $ where as $ key=> $ value){ 
$ select -> where( $ key. '=?', $ value); 
} 
) 
if ( $order)( 
$ select -> order( $ order); 
) 
$ result = $ this -> fetchAll( $ select); 
if ( $ result) { 
return $ result; 
) 
else( 
return null; 


) 


} 


11.4.3 日 程 信息 管理 功能 的 实现 


日 程 信息 管理 功能 的 实现 与 第 10 章 中 的 事务 信息 管理 基本 相似 ,为 了 节省 篇 幅 ,这 里 
只 介绍 “日 程 查询 ” 子 模块 中 的 部 分 功能 ,其 他 请 参考 教材 源 代码 。 
如 图 11.7 所 示 ,日 程 查询 是 通过 用 户 单 击 页 面 中 的 电子 台历 进行 的 , 当 用 户 单 击 台 
中 的 某 一 天 时 ,会 在 “今日 工作 ”视图 页 面 中 显示 当天 的 工作 安排 。 这 里 的 电子 台历 实现 了 
年 月 的 前 后 滚动 ,使 用 非常 方便 。 
下 面 是 Schedule 控制 器 的 search 方法 代码 及 说 明 。 
public function searchAction() 
t 
$ tine - array(); 
$ date = new Zend Date(); 
该 代码 使 用 new 运算 符 创建 一 个 Zend Date 对 象 ,用 来 处 理 日 期 与 时 间 。 这 里 类 的 构 
造 方法 中 没有 带 任何 参数 ,表示 获取 当前 系统 。 
Zend Date 组 件 负 责 Zend Framework 应 用 中 的 日 期 时 间 操 作 , 它 属于 典型 的 西方 式 日 
期 解决 方案 ,通过 它 可 以 执行 日 期 时 间 数 据 的 多 种 运算 .在 使 用 前 必须 设置 用 户 默认 时 区 。 
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$ today = $ date -> toArray(); 
$ time[ 'year'] = $ today[ 'year']; 
$ time[ 'month'] = $ today[ 'month']; 
$ time[ 'day'] = $ today[ 'day']; 
将 当前 日 期 的 年 .月 .日 从 日 期 时 间 对 象 date 中 取出 ,并 存放 在 time 数组 中 。 请 大 家 
注意 从 对 象 中 取出 数据 的 方法 。 
$ year = $ this -> getRequest() -> getParam( 'year'); 
$ month- $ this - > getRequest() -> getParam( month'); 
接收 请 求 中 的 “年 >"“ 月 ?参数 ,这 里 处 理 的 是 用 户 单 击 电子 台历 中 的 “年 ?或 "月 ”的 前 后 
滚动 按钮 操作 。 
证 ($Year){ 
$ tine[ 'year'] = $ year; 
$ date- $ date -> setYear( $ year); 


! 
if ( $ month && ( $ month» 0 && $ month « 13))( 


$ tine[ 'year'] - $ year; 
$ date- $ date -> setYear( $ year); 
$ time[ 'month'] = $ month; 
$ date = $ date -> setMonth( $ month) ; 
} 
如 果 能 够 接收 到 请 求 中 的 “年 "“ 月 ?参数 ,说 明 用 户 正 在 进行 “年 ?或 “月 ”的 滚动 操作 ， 
此 时 必须 同步 更 新 台历 页 面 , 即 重新 设置 日 期 时 间 对 象 date 中 的 日 期 数据 。 
$ days0 = array( $ date -> sub( $ time[ 'day'] - 1, Zend Date: :DAY) 一 > toArray()); 
对 于 图 11. 7 所 示 的 页 面 ,日 历 中 每 月 显示 的 都 是 6 周 时 间 , 共 计 42 天 ,不 属于 本 月 的 
日 期 是 用 暗 灰色 表示 的 。 代 码 中 的 days0 表示 “本 月 ”的 第 1 日 。 这 里 的 sub 是 Zend. Date 
类 的 方法 ,其 具体 用 法 请 参考 Zend Framework 使 用 手册 或 源 文件 。 
$ days[1] = array( $ date -> sub( $ days0[0]['weekday'], Zend Date::DAY) -> toArray()); 
获取 到 “本 月 ”的 第 1 日 后 , 青 往 前 推 至 该 周 的 星期 日 。 这 一 个 “星期 日 " 即 是 台历 显示 
的 第 1 天 日 期 。 


for( $i=2;$i<=42;$ i++){ 
$ days[ $ i] = array( $ date -> add(1, Zend Date: :DAY) -> toArray()); 


) 


$ this -> view -> days = $ days; 
$ this- >view->time= $ time; 

} 

得 到 台历 要 显示 的 第 1 天 日 期 后 ,使 用 Zend_Date 类 的 add 方法 以 步 长 为 1 依次 获得 
台历 中 的 每 一 天 的 日 期 对 象 . 并 将 其 保存 在 对 象 数组 中 。 在 视图 中 输出 这 42 天 , 即 可 看 到 
如 图 11.7 所 示 的 效果 。 

下 面 是 “日 程 查询 ”的 视图 文件 代码 : 


<?php require once 'schedulecss. php'?> 
<?php require once 'scheduleleft.phtml'?» 
<div id= "message"»« div id = "mscontent"» 
«h2 class= "pagetitle"> 日 程 安排 : <b> 日 程 查询 </b></h2 > 
<div align="left"> 
<ul class = "messagemenu"> 
<li><a href = "/schedule/add"> 
< ing src = "/images/addBtn. jpg" alt = "新 事务 "> </a></1i> 
<li><a href =" # ">< ing src = "/images/queryBtn. jpg" ></a></li> 
</ul> 
<hr /> 
</div> 
<div id= "msmain"> 
< table width = "100 % " border = "0" cellspacing = "0" cellpadding = "1" 
class = tablel style = "font - size:18px;" align = "center"> 
< tr style = "background: # cccccc;text - align:ceter; "> 
< td colspan = "2" style = "color: # ff6600;height: 30x; text - align:center"> 
<a href = "javascript :window. location. href = '<?php echo $ this -> baseUrl 
('/schedule/search/year/'. ( $ this -> time[ 'year'] - 1)) ?>'"> 
< img src = '/images/prev. gif' /></a> &nbsp; &nbsp; ^F. &nbsp; &nbsp; 
<a href = "javascript :window. location. href = '<?php echo $ this -> baseUrl 
('/schedule/search/year/'. ( $ this -> time['year'] +1)) ?>'"> 
< img src = '/images/next. gif' /></a> 
</td> 
< td colspan = "3" align = "center"><?php echo $ this -> time['year'] ?> 
年 <?php echo $ this -> time[ 'nonth'] ?> 月 </td> 
< td colspan = "2" align = "center"> 
<a href = "javascript :window. location. href = '<?php echo $ this -> baseUrl 
('/schedule/search/year/'. $ this -> time[ 'year']. '/month/'. 
( $ this -> time[ 'nonth'] 一 1)) ?>""> 
< img style = "cursor: hand" src = '/images/prev.gif' /> 
</a> &nbsp;&nbsp; H &nbsp;&nbsp; 
<a href = "javascript:window. location. href = '«?php echo $ this -> baseUrl 
( '/schedule/search/year/'. $ this -> time[ 'year']. '/month/'. 
( $ this -> time[ 'month'] + 1)) ?>""> 
< ing style = "cursor:hand" src = '/images/next.gif' /></a> 
</td> 
</tr> 
<tr> 
<td align = center class = tr head width= 14 $ height = 40 > 
< font color = "red"> H «/font ></td> 
< td align = center class = tr head width = 14 $»—«/td» 
< td align = center class = tr head width = 14 $» —«/td» 
< td align = center class = tr head width = 14 $» —«/td» 
< td align = center class = tr head width = 14%> 四 </td> 
< td align = center class = tr head width = 14%> 五 </td> 
< td align = center class = tr head width = 14 $»7X«/td» 
</tr> 


HZ% 
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<?php foreach ( $ this -> days as $ day )( 
if( $ day[0][ weekday'] == '7') 
echo "<tr>"; 
echo "< td align = center style = 'cursor:hand;line- height:30px;"; 
if ( $ day[0]['month']!= $ this -> time[ 'month']) 
echo "color: & cccccc;"; 
if ( $ day[0][ weekday'] == '7' && 
$ day[0][ month'] == $ this—> time[ month']) 
echo "color: # ££0000;"; 
if ( $ day[O]['day'] == $ this -> time['day'] && 
$ day[0]['month'] == $ this -> time[ 'month']) 
echo "background: # ff8800;"; 
echo "'"." onclick = javascript :window. location. href = 
", " '/schedule/work/year/". $ day[0][ 'year']. "/month/ 
". $ day[ 0][ 'nonth']. "/day/". $ day[0][ 'day']. ">"; 
echo $ day[0][ 'day']. "</td>"; 
if( $ day[0][ 'weekday'] == '6') 
echo "</tr>"; 
p 
«/table »«/div »«/div»«/div» 


注意 : 上 述 代码 中 的 6 个 阴影 部 分 ,它们 分 别 实现 事务 的 添加 、 年 份 的 前 后 滚动 .月份 
的 前 后 滚动 ,不 同日 期 的 背景 颜色 设置 以 及 用 户 单 击 某 日 后 的 页 面 跳 转 功能 。 


11.5 本 章 小 结 


本 章 介绍 了 办 公 自 动 化 管理 系统 中 常用 办 公 功 能 的 实现 ,包括 用 户 网 络 空间 .日 程 安排 
的 创建 与 管理 。 用 户 网 络 空间 类 似 于 一 个 简单 的 资源 管理 器 ,能 够 进行 文件 夹 的 创建 与 删 


除 .文件 的 复制 与 粘贴 等 基本 功能 。 


本 章 在 实现 应 用 功能 的 过 程 中 进一步 介绍 了 Zend Framework 视图 助手 的 使 用 方法 ， 


同时 引入 了 新 的 Zend_Date 时 间 日 期 组 件 ,这 些 内 容 是 本 章 的 学 习 重点 。 


第 12 章 用 户 权 限 及 系统 优化 


通过 前 面 章节 的 介绍 ,一 个 办 公 自 动 化 管理 系统 的 Web 应 用 已 经 基本 成 形 。 但 细心 的 
读者 可 能 会 发 现 ,在 整个 系统 中 ,除了 在 第 7 章 的 用 户 认 证 中 写 过 少量 的 访问 控制 代码 外 ， 
没有 编写 其 他 任何 关于 用 户 权 限 的 内 容 。 如 果 任 意 一 个 访问 者 都 可 以 访问 像 系 统 后 台 管理 
中 心 这 样 的 功能 模块 ,那么 这 个 后 台 管 理 就 没有 什么 作用 和 意义 了 。 系 统 除 了 用 户 访问 控 
制 权限 方面 的 缺憾 之 外 ,在 其 他 许多 地 方 还 存在 一 些 需 要 完善 的 地 方 。 

本 章 实现 办 公 自 动 化 管理 系统 的 访问 控制 缓存 等 Web 应 用 优化 技术 方案 ,由 此 介绍 
Zend Framework 的 Zend Acl 以 及 Zend_Cache 组 件 。 另 外 ,还 将 通过 介绍 验证 码 、 系 统 日 
志 以 及 数据 备份 的 实现 对 系统 进行 简要 完善 。 


12.1 Zend_Acl 访问 控制 


Zend Framework 中 的 访问 控制 通过 ACL 访问 控制 列表 (Access Control List) 来 实现 。 
所 谓 访问 控制 列表 ,通俗 地 讲 就 是 权限 控制 ,应 用 程序 可 以 利用 这 样 的 功能 限制 某 一 类 用 户 
来 访问 特定 保护 的 对 象 。 其 中 ,用 户 常 被 称 为 角色 (Role) ,被 访问 的 对 象 被 称 为 资源 
(Resource) ,所 以 ACL 的 核心 功能 就 是 允许 或 限制 某 一 类 Role 访问 某 些 Resource。 在 我 
们 的 应 用 中 ,ACL 中 的 角色 即 用 户 的 身份 ,资源 即 系统 内 容 ,而 权限 就 是 角色 能 访问 哪些 内 
容 , 不 能 访问 哪些 内 容 。 

使 用 Zend Framework 中 的 Zend. Acl 组 件 即 可 实现 完整 的 访问 控制 。 该 组 件 提供 了 
一 整套 实现 访问 控制 列表 的 解决 方案 。Zend_Acl 组 件 的 权限 控制 设计 得 非常 完美 ,理解 和 
使 用 简单 ,通用 性 也 非常 好 。 


12.1.1 资源 与 角色 


Zend Framework 的 Zend Acl 组 件 中 定义 了 两 个 重要 的 概念 , 即 资源 与 角色 。 资 源 是 
指 一 个 被 限制 访问 的 对 象 ; 角色 则 是 指 可 以 发 出 请 求 来 访问 资源 的 对 象 。Zend_Acl 组 件 
中 分 别 以 Zend. Acl. Role 类 与 Zend Acl. Resource 类 表示 资源 与 角色 。 

1. 资源 

在 Zend Framework 中 ,resource 可 以 是 任何 事物 ,例如 一 个 Controller. 一 个 Action, 
一 个 Model 或 者 一 个 File 等 。 可 以 简单 地 把 资源 理解 为 一 个 可 供 访 问 的 对 象 ,例如 某 一 个 
页 面 。 

Zend Acl 组 件 提供 了 一 个 树 结构 , 它 可 以 添加 多 个 Resource( 或 者 叫 “ 访 问 控 制 下 的 区 
W”). AA Resource 被 存储 在 这 样 一 个 树 结构 中 ,所 以 它们 可 以 被 组 织 成 从 一 般 ( 树 根 ) 到 


PHP Zend Framework 5t A FÆ E 2h € s] 308 


特殊 (树叶 )。 基 于 特殊 resource 的 查询 将 自动 从 Resource 的 等 级 结构 中 搜索 每 个 资源 的 
父 类 Resource 所 具有 的 规则 , 它 允 许 简单 的 规则 继承 。 例 如 ,要 把 一 个 默认 的 规则 应 用 到 
系统 中 的 功能 模块 的 每 个 页 面 , 就 简单 地 把 这 个 规则 分 配给 该 模块 的 控制 器 ,而 不 是 把 规则 
分 配给 该 控制 器 的 每 个 页 面 。 然 而 ,有 些 页 面 也 许 要 求 特 定 的 规则 ,这 在 Zend Acl 里 也 是 
很 容易 实现 的 。 一 个 Resource 可 以 从 唯一 的 一 个 父 Resource 继承 ,而 这 个 父 Resource 也 
有 它 自己 的 父 Resource 等 。 

在 Zend Acl 中 ,创建 一 个 资源 非常 简单 。Zend_Acl 提供 了 Zend. Acl. Resource _ 
Interface 接口 ,该 接口 使 开发 者 可 以 非常 方便 地 创建 Resource, 为 了 使 Zend. Acl 把 某 个 对 
象 当 作 一 个 Resource ,一 个 类 只 需要 实现 包含 了 方法 getResourceId() 的 接口 即 可 。 另 外 ， 
Zend Acl Resource 是 一 个 包含 在 Zend. Acl 里 作为 一 个 基本 的 Resource 实现 的 类 ,开发 
者 可 以 任意 对 其 进行 扩展 。 

2. 角色 

与 资源 相对 应 ,在 Zend. Acl 组 件 中 ,角色 就 是 一 个 发 出 希望 访问 某 个 资源 请 求 的 对 
象 , 通 常理 解 为 一 个 用 户 所 具有 的 身份 ,这 个 身份 由 我 们 自行 定义 。 在 Zend. Acl 中 ,Role 
支持 规则 的 继承 ,一 个 Role 可 以 从 一 个 或 多 个 Role 继承 。 例 如 在 本 系统 中 ,我 们 设置 普通 
职工 的 角色 为 user、 部 门 管理 员 的 角色 为 editor, 角 色 editor 继承 于 角色 user, 它 拥有 user 
的 所 有 访问 权限 。 

角色 与 资源 一 样 ,其 创建 过 程 也 非常 简单 。Zend_Acl 提供 了 Zend Acl Role Interface 
接口 ,为 了 让 Zend_Acl 把 某 个 对 象 当 作 一 个 Role, 一 个 类 只 需要 实现 这 个 只 包含 了 一 个 
getRoleld() 方 法 的 接口 即 可 。 与 Zend. Acl. Resource 一 样 ,Zend_Acl_Role 也 是 一 个 包含 
TE Zend. Acl 中 作为 一 个 基本 的 Role 实现 的 类 。 


12.1.2 Zend Acl 的 创建 与 使 用 


在 理解 了 Zend Acl 中 的 资源 与 角色 后 ,下 面 介绍 如 何 创建 并 使 用 访问 控制 列表 。 

1. 创建 ACL 

从 上 面 关 于 访问 控制 列表 ,资源 与 角色 的 定义 可 以 看 出 ,ACL 可 以 表示 任何 一 组 物理 
或 虚拟 对 象 。 创 建 一 个 新 的 ACL 对 象 ,可 以 使 用 new 关键 字 不 带 参数 地 实例 化 Zend_ 
Acl 类 。 


$ acl = new Zend Acl(); 


注意 : 如 果 不 定义 任何 访问 权限 , 则 默认 的 ACL 将 禁止 所 有 的 Role 访问 任何 Resource; 

2. 添加 资源 

将 资源 添加 到 访问 控制 列表 中 可 以 使 用 Zend. Acl 实例 的 addResource 方法 ,该 方法 的 
语法 格式 如 下 : 


addResource( $ resource, $ parent = null) 


其 中 ,参数 resource 为 需要 添加 的 资源 ,可 以 为 字符 串 、 数 组 或 者 源源 对 象 ; 可 选 参数 
parent 为 参数 role 继承 的 父 资源 。 

3. 注册 角色 

要 将 指定 的 角色 注册 到 访问 控制 列表 中 ,可 以 使 用 访问 控制 列表 实例 的 addRole 方法 。 


该 方法 的 语法 格式 如 下 : 
addRole( $ role, $ parents = null) 


其 中 ,参数 role 为 需要 注册 的 角色 ,可 以 为 角色 对 象 . 字 符 串 或 者 数组 ; 可 选 参数 
parents 为 参数 role 继承 的 父 角 色 。 

4. 定义 访问 控制 

在 访问 控制 列表 中 ,为 指定 注册 角色 添加 允许 权限 可 以 使 用 ACL 对 象 的 allow 方法 。 
该 方法 的 语法 格式 如 下 : 


allow( $ roles = null, $ resources = null, $ privileges = null, Zend Acl Assert Interface 


$ assert = null) 


其 中 ,参数 role 为 指定 的 角色 ,可 以 为 角色 .字符 串 或 者 数组 ; 参数 resource 为 允许 使 
用 的 资源 ,可 以 为 资源 .字符 串 或 者 数组 ,默认 值 为 null, 即 所 有 资源 ; 参数 privileges 为 允 
许 使 用 的 权限 ,可 以 为 字符 串 或 者 数组 ; 参数 assert 为 实现 了 Zend_Acl_Assert_Interface 
接口 对 象 ,用 来 定义 访问 的 条 件 。 

相应 地 ,也 可 以 为 角色 添加 拒绝 权限 ,使 用 ACL 对 象 的 deny 方法 即 可 为 角色 添加 拒绝 
权限 。 该 方法 的 语法 格式 如 下 : 


deny( $ role, $ resource, $ privilege, $ assert); 


其 中 各 参数 的 意义 与 方法 allow 相同 。 执 行 该 方法 将 为 指定 角色 添加 拒绝 权限 。 

5. 移 除 控制 规则 

由 于 某 种 需要 ,在 使 用 访问 控制 列表 时 可 能 需要 对 其 中 定义 的 控制 规则 进行 移 除 ,此 时 
可 以 使 用 ACL 对 象 的 removeAllow 方法 与 removeDeny 方法 将 指定 规则 进行 移 除 。 这 两 
个 方法 的 语法 格式 分 别 如 下 : 


removeAllow( $ roles = null, $ resources = null, $ privileges = null) 
removeDeny( $ roles - null, $ resources - null, $ privileges - null) 


其 中 各 参数 的 意义 与 方法 allow 相同 。 它 们 所 带 的 参数 均 可 以 省 略 , 当 不 带 任何 参数 
执行 方法 时 ,表示 移 除 所 有 用 户 资源 的 所 有 允许 或 拒绝 操作 。 

6. 查询 控制 状态 

使 用 访问 控制 列表 对 象 的 isAllowed 方法 可 以 对 指定 角色 是 否 有 指定 权限 进行 查询 ， 
执行 该 方法 将 会 根据 指定 角色 是 否 有 某 种 操作 权限 返回 相应 的 布尔 值 。 其 语法 格式 如 下 : 


isAllowed( $ role= null, $ resource = null, $ privilege = null) 


其 中 各 参数 的 意义 与 方法 allow 相同 。 


12.2 系统 访问 控制 的 实现 


Zend Framework 提供 的 Zend Acl 组 件 功能 强大 、 使 用 灵活 且 直 观 。 在 实际 应 用 过 程 
中 ,我 们 需要 将 ACL 文件 写成 插件 形式 ,并 在 其 中 定义 资源 和 角色 ,设置 好 相应 的 规则 ,这 
样 它 就 可 以 很 好 地 工作 。 下 面 实现 本 系统 案例 项 目的 访问 控制 功能 。 


用 户 权 限 及 系统 优化 
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12.2.1 系统 角色 及 权限 的 设置 


在 第 6 章 中 创建 了 用 户 信息 数据 表 tb_user, 其 中 有 一 个 名 为 role 的 字段 , 它 表示 的 就 
是 用 户 的 角色 信息 。 为 了 简单 ,本 系统 设置 4 种 角色 , 即 admin, editor, user 和 guest, © f] 
分 别 表示 “系统 管理 员 ”“ 部 门 管理 员 ”“ 普 通用 户 ” 及 “匿名 用 户 ”。 

匿名 用 户 拥 有 最 小 的 权限 ,只 能 访问 系统 封面 主页 .用 户 登 录 及 系统 功能 与 使 用 说 明 、 
重 置 密码 页 面 , 也 就 是 说 没有 登录 的 用 户 不 能 进入 系统 内 部 ; 系统 管理 员 用 户 享 有 全 部 权 
限 , 可 以 访问 所 有 资源 。 介 于 这 两 者 之 间 的 是 普通 用 户 与 部 门 管理 员 ,其 中 普通 用 户 在 系统 
前 台 管理 中 有 较 多 权限 ,可 以 浏览 ,创建 ,更 新 甚至 删除 某 些 内 容 , 但 不 能 进入 后 台 管 理 系 
统 ; 而 部 门 管理 员 拥 有 系统 管理 员 的 部 分 权限 ,可 以 通过 后 台 管理 中 心 添加 、 编 辑 、 删 除 部 
分 内 容 。 例 如 ,可 以 添加 单个 用 户 注 册 信 息 , 但 不 能 批量 注入 。 

从 guest 到 user, 再 到 editor、admin, 越 往 后 权限 越 大 ,前 者 拥有 的 权限 后 者 都 有 ,后 者 
拥有 的 权限 前 者 不 一 定 拥有 , 即 后 者 的 权限 包含 前 者 ,这 就 是 前 面 所 讲 的 角色 的 继承 。 

通过 第 2 章 的 学 习 我 们 已 经 知道 ,Zend Framework 应 用 的 资源 内 容 是 通过 MVC 形式 
被 创造 和 访问 的 ,其 中 的 C( 也 就 是 控制 器 及 其 方法 ) 是 调度 这 些 内 容 的 核心 。 当 我 们 罗列 
出 控制 器 及 其 方法 时 ,也 就 列 出 了 应 用 的 资源 。 然 后 指定 相应 角色 的 权限 , 即 规定 哪些 角色 
可 以 访问 哪些 资源 ,哪些 角色 不 可 以 访问 哪些 资源 ,这 样 就 可 以 实现 整个 系统 的 访问 控 
制 了 。 

表 12. 1 所 示 为 本 系统 中 资源 、 角 色 及 权限 的 对 应 关系 。 由 于 系统 资源 较 多 , 表 中 只 列 
出 了 部 分 内 容 , 其 他 内 容 与 表 中 内 容 类 似 。 


表 12.1 系统 资源 .角色 及 权限 对 应 表 


资源 角色 
控制 器 模块 方法 guest user editor admin 
; diie d y y y 
index main x v v v 
admin index x x "i ~ 
index x v ~v ~v 
login ~J vV vV ~ 
logout x si ~ Af 
default register x ~ ~ xf 
account x v v v 
resetpassword vV v Jv v 
update x ~ Af a 
user index x x ~ ~ 
insert x x x a 
register x x J "m i 
admin delete x x X 好 
search x x vV v 
list x x v v 
detail x x vV "i 


续 表 


资源 角色 
控制 器 模块 方法 guest user editor admin 
index x ~ ~ ~ 
list x ~ ~ ~ 
default | docdetail x Fj 以 ~ 
issue x x a ~ 
receive x -J ~ 
index x x a wi 
document insert x x x J 
register x x vV vV 
admin delete X X x JJ 
search x x E d m 
list x x m ~ 
detail P d x m ~ 
index x Jl Af m 
default Sud a y nl y 
list x v v v 
affair reply x x J Ri 
index x x ~ ~ 
admin list x x NA v 
delete x x x ~ 


设置 好 整个 系统 的 权限 后 , 接 下 来 就 可 以 编写 代码 实现 系统 的 访问 控制 了 。 在 编写 代 
码 之 前 还 必须 弄 清 楚 一 个 问题 ,就 是 访问 控制 代码 文件 应 该 在 什么 时 候 被 执行 。 判 断 用 户 
能 否 访问 某 一 资源 并 做 出 相应 的 控制 措施 需要 在 框架 处 理 具体 的 控制 器 方法 之 前 触发 ,所 
以 访问 控制 的 实现 需要 以 插件 的 形式 完成 。 


12.2.2 开发 系统 ACL 插件 


使 用 Zend_Acl 组 件 实现 访问 控制 分 为 以 下 3 个 步骤 : 

(1) 继承 Zend Controller Plugin Abstract 类 建立 plugin 插件 ,通过 preDispatch() 方 
法 定义 插件 什么 时 候 执行 ; 

(2) 建立 角色 和 资源 ; 

(3) 对 每 个 资源 加 入 角色 权限 控制 。 

1. 编写 插件 

首先 在 项 目的 library 目录 下 创建 wmoams\controllers\plugins 目录 ,然后 在 其 中 创建 
Acl. php 插件 文件 ,这 个 插件 只 需要 包含 并 扩展 抽象 类 Zend_Controller_Plugin_Abstract, 代 码 
如 下 : 

class WmOAMS Controller Plugin Acl extends Zend Controller Plugin Abstract 

{ 


public function preDispatch( 
Zend Controller Request Abstract $ request) 
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$ acl = new Zend Acl(); 

$ acl - > addRole( 'guest') ; 

$ acl - > addRole( 'user', 'guest'); 

$ acl - » addRole( 'editor', 'user'); 

$ acl - » addRole( 'adnin'); 

$ acl - > addResource( 'index'); 

$ acl - > addResource( 'user'); 

$ acl - > addResource( 'adnin. index'); 


$ acl - > addResource( 'news') ; 

$ acl - > addResource( 'schedule'); 

$ acl -> deny( 'guest', null, null); 

$ acl - »allow('guest', 'index',array( 'index')); 

$ acl -> allow( 'guest', 'user', array( 'login', 'resetpassword')); 

$ acl -» allow('user', 'index', array( 'main')); 

$ acl- » allow('user', 'user', array( 'index', 'logout', 'register', 'account', 'update')); 


$ acl -» allow( 'editor', 'admin. index', array( 'index')); 
$ acl -> allow( 'editor', 'admin. user', array( 'index', 'register', 'list', search', 'detail')); 


$ acl - » allow( 'admin', null, null); 
$ auth 7 Zend Auth: :getInstance(); 
if( $ auth- » hasIdentity()) ( 
$ identity = $ auth - » getIdentity(); 
$ role- strtolower( $ identity -> role); 
}else{ 
$ role= 'guest'; 
} 
$ module = $ request - > module; 
$ controller = $ request - » controller; 
$ action= $ request - > action; 
if( $ module === 'default'){ 
$ resource = $ controller; 
}else{ 
$ resource = $ module. '. '. $ controller; 
} 
$ isExist = array search( $ resource, $ acl - > getResources( ) ); 
if(! $ isExist && $ isExist !-- 0 ){ 
if ($role-- 'guest' ) ( 
$ request - > setControllerName( 'index'); 
$ request 一 > setActionNanme( 'index'); 
) eise ( 
$ request - » setControllerName( 'error'); 
$ request - > setActionName( 'noresource'); 
) 
Jelseif(! $ acl- » isAllowed( $ role, $ resource, $ action)) ( 
if ($role-- 'guest') ( 
$ request -> setControllerName( 'index'); 
$ request -> setActionName( 'index');s 
) else ( 
$ request - » setControllerName( 'error'); 
$ request 一 > setActionName( 'noac'); 


在 讲解 上 述 代 码 之 前 先 来 介绍 一 下 插件 。 所 谓 plugin 插件 ,顾名思义 就 是 要 在 正常 的 
框架 执行 流程 中 的 某 个 环节 处 打 断 原 有 的 流程 ,插入 由 开发 者 自行 开发 的 插件 程序 。 一 个 
plugin 必须 继承 Zend Controller Plugin Abstract 类 并 重 载 某 些 方 法 来 实现 相应 的 功能 ， 
其 中 常用 的 方法 有 下 面 几 种 。 

* routeStartup: 在 Zend Controller Front 向 注册 的 路 由 器 发 送 请求 前 被 调用 。 

* routeShutdown: 在 路 由 器 完成 请 求 的 路 由 后 被 调用 。 

* dispatchLoopStartup: 在 Zend_Controller_Front 进入 其 分 发 循环 前 被 调用 。 

* preDispatch: 在 动作 由 分 发 器 分 发 前 被 调用 。 该 回调 方法 允许 代理 或 者 过 滤 行 为 ， 

通过 修改 请 求 和 重 设 分 发 标志 位 使 当前 动作 可 以 跳 过 或 者 被 替换 。 

* postDispatch: 在 动作 由 分 发 器 分 发 后 被 调用 。 该 回调 方法 允许 代理 或 者 过 滤 行 

为 ,通过 修改 请 求 和 重 设 分 发 标志 位 指定 新 动作 进行 分 发 。 

* dispatchLoopShutdown: 在 Zend Controller. Front 退出 其 分 发 循环 后 调用 。 

preDispatch 在 调用 具体 action 之 前 触发 ,所 以 在 这 个 地 方 可 以 添加 权限 认证 .URL 转 
发 等 动作 ; 而 postDispatch 在 调用 action 之 后 触发 ,在 这 个 地 方 可 以 做 输出 缓存 等 。 

关于 路 由 的 问题 ,对 初学 者 来 说 有 一 定 的 难度 ,本 书 不 做 介绍 。 有 了 上 面 关 于 插件 的 一 
些 基本 知识 以 后 ,我们 再 来 看 看 上 面 的 插件 代码 。 

代码 共 分 为 下 面 8 个 部 分 : 

D 插件 类 的 定义 

基 类 为 Zend_Controller_Plugin_Abstract 类 的 WmOAMS_Controller_Plugin_Acl 类 
中 实现 了 一 个 名 为 preDispatch 的 方法 ,该 方法 的 参数 是 当前 的 一 个 request 请 求 , 如 上 所 
述 , 这 个 方法 被 定义 为 将 在 动作 由 分 发 器 分 发 前 被 调用 ,也 就 是 说 访问 控制 代码 是 在 控制 器 
方法 action 被 分 发 前 执行 的 。 如 果 在 执行 访问 控制 代码 时 发 现 发 出 请 求 的 用 户 没 有 访问 该 
控制 器 方法 的 权限 ,那么 原来 的 请 求 路 径 就 会 被 更 改 , 这 样 该 用 户 的 此 次 请 求 就 不 能 访问 到 
请 求 的 视图 页 面 , 从 而 实现 了 对 访问 的 控制 。 

2) 创建 ACL 对 象 

通过 new Zend_Acl() 的 形式 创建 名 为 acl 的 ACL 对 象 。 

3) 注册 角色 

使 用 ACL 对 象 的 addRole 方法 注册 系统 角色 。 其 中 ,user、editor 采用 了 继承 的 方式 ; 
admin 拥有 全 部 权限 ,不 需要 继承 。 

4) 添加 资源 

使 用 ACL 对 象 的 addResource 方法 添加 系统 资源 。 如 上 所 述 ,这 里 的 资源 指 系统 中 的 
控制 器 。 由 于 系统 模块 中 的 控制 器 可 能 重 名 ,我 们 把 资源 名 前 加 上 了 控制 器 所 属 模块 的 名 
字 , 如 果 是 默认 模块 , 则 不 添加 。 例 如 ,代码 中 的 资源 index admin. index 分 别 代表 默认 模 
H default 和 后 台 管理 模块 admin 中 的 index 控制 器 。 

5) 定义 访问 控制 

使 用 ACL 对 象 的 deny 和 allow 方法 定义 角色 的 访问 控制 ,访问 控制 规则 遵循 
表 12. 1 中 的 设 定 。deny 和 allow 方法 中 的 第 3 个 参数 表示 访问 权限 ,我 们 用 控制 器 的 方法 
名 来 设置 。 也 就 是 说 ,只 要 能 在 访问 权限 字符 中 找到 相应 控制 器 的 方法 即 可 访问 该 方法 对 
应 的 视图 页 面 。 
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6) 获取 用 户 角 色 

根据 用 户 登 录 认 证 信息 获取 用 户 角 色 信息 , 若 用 户 未 登录 , 则 为 匿名 用 户 guest。 

7) 获取 资源 并 判断 是 否 存在 

从 请 求 对 象 request 中 获取 模块 ,控制 器 及 方法 。 若 为 默认 模块 ,直接 将 控制 器 名 当 作 
资源 ; 若 为 其 他 模块 , 则 在 控制 器 名 前 加 “模块 名 . ”后 赋 给 资源 变量 resource。 

资源 的 存在 与 否 通过 PHP f PRA array. search 的 返回 值 判 断 。 若 资源 存在 ,返回 注册 
资源 的 索引 ,注意 有 索引 为 0 的 资源 ; 若 资源 不 存在 ,返回 false。 从 上 面 的 代码 可 以 看 出 ， 
若 匿名 用 户 访问 本 系统 ,请 求 资源 不 存在 时 ,页 面 一 律 跳 转 至 系统 封面 页 面 ; 若是 登录 用 户 
请 求 的 资源 不 存在 , 则 统一 跳 转 到 错误 控制 器 Error 的 “资源 不 存在 ”提示 页 面 。 

8) 检验 访问 权限 

使 用 ACL 对 象 的 isAllowed 方法 检验 用 户 的 权限 。 若 匿名 用 户 没有 访问 权限 , 则 页 面 
跳 转 至 系统 封面 ; 若 登 录用 户 没 有 访问 权限 , 则 页 面 跳 转 到 错误 控制 器 的 “资源 不 存在 ” 提 
示 页 面 。 

2. 注册 插件 

访问 控制 插件 代码 编写 完成 之 后 ,还 需要 在 配置 文件 中 添加 代码 开启 它 。 打 开 配 置 文 
件 application\cofigs\application. ini, Æ production 小 节 添 加 如 下 代码 : 

autoloaderNamespaces[] = "WmOAMS " 

resources. frontController.plugins.acl = "WmOAMS Controller Plugin Acl" 

到 此 为 止 .— A JI iE RC o FED JE CER Fe wl AR SE Y. ET RAO IRE 
F ACL 的 控制 之 下 ,访问 系统 中 的 任何 一 个 页 面 都 要 经 过 插件 中 ACL 规则 的 检查 。 只 有 
符合 ACL 访问 规则 的 页 面 才 会 正常 呈现 在 访问 者 的 面前 ,否则 系统 会 重新 定向 到 系统 封 
面 、 错 误 提 示 页 面 或 者 抛 出 错误 。 


12.3 系统 的 优化 


Web 应 用 系统 的 性 能 受到 各 种 因素 的 影响 ,因此 系统 的 优化 必须 考虑 到 整个 系统 的 方 
方面 面 ,侧重 点 不 同 、 应 用 场景 不 同 , 采 用 的 优化 策略 也 应 该 不 尽 相 同 。 评价 Web 应 用 系统 
性 能 主要 有 两 项 指标 ,一 是 客户 端 响 应 时 间 , 二 是 服务 器 的 吞吐 量 ,因此 系统 的 优化 应 围绕 
这 两 个 方面 展开 。 男 外 ,Web 应 用 系统 的 性 能 优化 还 必须 考虑 系统 的 开发 语言 与 采用 的 设 
计 模 式 。 本 节 主 要 介绍 数据 缓存 的 性 能 优化 策略 。 


12.3.1 Zend Cache 数据 缓存 


数据 缓存 作为 一 种 Web 应 用 的 性 能 优化 方法 ,是 Web 应 用 程序 几乎 都 要 用 到 的 技术 
方案 。 对 于 访问 量 较 大 的 应 用 来 说 ,使 用 缓存 可 以 极 大 地 减轻 数据 库 服务 器 的 压力 ,解决 由 
此 产生 的 性 能 瓶颈 。 

Zend Framework 的 Zend Cache 是 一 个 理想 的 缓存 组 件 ,提供 了 缓存 程序 中 任何 数据 
的 方法 。 下 面 简单 介绍 缓存 原理 及 Zend Cache 的 使 用 。 

1. 缓存 实现 原理 

缓存 是 指 将 一 些 数据 存放 在 固定 的 载体 (如 Session、Cookie、 文 件 或 者 数据 库 ) 中 ,需要 


时 再 读 出 的 这 样 一 个 过 程 。 在 Zend_Cache 缓存 架构 中 ,数据 的 缓存 由 前 端 (Frontend) 和 后 
端 (Backend) 相 互 配合 完成 。 

Zend_Cache 中 的 前 端 与 后 端 互 有 分 工 ,前 端 提供 缓存 的 对 象 ,通过 后 端 适配器 和 一 个 
灵活 的 IDs 与 Tags 系统 存储 缓存 记录 ,以 使 访问 精准 定位 到 前 端 缓存 页 面 。 数 据 缓存 一 般 
按照 以 下 流程 实现 : 

。 从 缓存 文件 夹 中 寻找 是 否 有 符合 条 件 的 缓存 文件 ; 

。 如 果 找 到 , 即 有 符合 条 件 的 缓存 文件 ,而 且 没 有 过 期 ,直接 将 该 文件 传递 给 浏览 器 ; 

。 如 果 没 找到 , 即 没 找到 符合 条 件 的 缓存 文件 , 则 检查 文件 是 否 已 过 期 ; 

。 如 果 没 找到 ,创建 该 文件 , 存 人 缓存 文件 夹 ,同时 将 文件 输出 到 浏览 器 。 

2. Zend Cache 前 端 

Zend, Cache 中 的 前 端 在 整个 数据 缓存 过 程 中 起 缓存 操作 的 作用 , 它 实 际 上 是 一 些 预 定 
义 类 ,主要 有 Zend Cache Core,Zend Cache Frontend Output,Zend Cache Frontend | 
Function,Zend. Cache Frontend. Class, Zend _ Cache. Frontend _ File, Zend. Cache. Frontend _ 
Capture LA Zend. Cache Frontend Page 等 ,其 中 ,Zend_Cache_Core 类 是 缓存 前 端的 核心 
类 ,也 是 其 他 前 端 类 的 基 类 。 

3. Zend Cache 后 端 

Zend Cache 中 的 后 端 负 责 对 缓存 数据 进行 保存 ,主要 包括 Zend Cache Backend File, 
Zend_Cache_Backend_Sqlite、Zend_Cache_Backend_Memcached、Zend_Cache_Backend _ 
Apc、Zend_Cache_Backend_Xcache、Zend_Cache_Backend_ZendPlatform 等 ,常用 的 是 Zend 
Cache Backend File 后 端 , 它 把 缓存 数据 存储 到 一 个 指定 的 目录 文件 中 。 

4. 创建 Zend_Cache 实例 

缓存 对 象 的 创建 通过 Zend. Cache 类 的 静态 方法 factory 实现 ,该 方法 的 语法 格式 如 下 : 


factory( $ frontend, $ backend, $ frontendOptions = array(), $ backendOptions = array()) 


其 中 ,参数 frontend 为 调用 的 Zend. Cache 前 端 组 件 ; 参数 backend 为 调用 的 Zend | 
Cache 后 端 组 件 ; 参数 frontendOptions 与 参数 backendOptions 分 别 为 前 端 与 后 端的 设置 
数组 。 在 以 上 4 个 参数 中 ,后 两 个 参数 为 可 选项 ,如 果 省 略 设 置 参 数 ,方法 将 采用 其 默认 值 。 

5. 向 缓存 中 写 人 数据 

向 缓存 中 写 人 数据 使 用 Zend. Cache Core 的 save 方法 实现 ,其 语法 格式 如 下 : 


save( $ data, $ id- null, $ tags = array(), $ specificLifetime = false) 


其 中 ,参数 data 为 需要 放 入 缓存 中 的 数据 内 容 , 其 类 型 为 mixed 混合 型 ; 可 选 参数 id 
为 缓存 的 ID 号 ,如 果 省 略 该 值 , 系 统 将 使 用 最 后 的 缓存 ID; 参数 tags 为 缓存 的 标识 ; 可 选 
参数 specificLifetime 为 一 个 布尔 型 变量 ,该 参数 指定 是 否 为 缓存 数据 设置 一 个 特殊 的 生命 
期 ,其 默认 值 为 false。 执 行 该 方法 将 会 把 缓存 数据 写 人 到 指定 的 前 端 缓存 中 。 

6. 清除 缓存 数据 

当 缓存 数据 不 再 需要 时 ,出 于 安全 性 及 节省 系统 资源 的 考虑 ,应 该 将 其 清除 。 该 操作 通 
过 Zend Cache Core 的 remove 方法 以 及 clean 方法 实现 ,其 中 remove 方法 用 于 清除 单个 
缓存 记录 。 其 语法 格式 如 下 : 
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remove( $ id) 


其 中 ,参数 id 为 指定 的 缓存 ID 号 。 
clean 方法 通常 用 于 清除 多 个 缓存 记录 , 它 的 语法 格式 如 下 : 


clean( $ mode = 'all', $ tags = array()) 


其 中 ,参数 mode 为 清除 模式 ,该 参数 的 可 选 值 如 下 。 

。 all: 清除 所 有 缓存 ,该 值 为 默认 值 ; 

* old: 仅 清 除 过 期 的 缓存 ; 

。 matchingTag: 清除 与 参数 tags 指定 的 标记 内 容 相 匹配 的 所 有 缓存 ; 

* notMatchingTag: 清除 与 参数 tags 指定 的 标记 内 容 不 相 匹 配 的 所 有 缓存 。 

参数 tags 是 参数 mode 为 matchingTag 或 者 notMatchingTag 时 指定 的 标记 类 型 ,该 
参数 可 以 是 数组 .字符 串 或 者 字符 。 


12.3.2 Zend Cache 数据 绥 存 实例 


在 了 解 了 Zend Cache 的 数据 缓存 原理 之 后 ,下 面 分 析 一 个 缓存 实例 。 该 实例 通过 组 
存 获取 本 书 案例 项 目 中 的 所 有 部 门 信息 。 

在 第 A 章 的 4.1 节 中 已 经 创建 了 一 个 名 为 Cache 的 缓存 对 象 ,并 把 它 存 放 在 了 注册 表 
中 ,这 里 只 需要 将 其 取出 使 用 即 可 。 

1. 缓存 参数 

缓存 的 前 端 与 后 端 参 数 可 以 在 创建 时 直接 通过 数组 设置 ,也 可 以 通过 配置 文件 
application. ini 配置 。 启 动 Zend Studio 集成 开发 环境 ,打开 项 目 wmProject 的 配置 文件 
application\cofigs\application. ini, 可 以 看 到 如 下 代码 ; 


cache. leftTime = "7200" 
cache.cache dir = APPLICATION PATH "/tmp/" 


代码 中 的 第 1 行 设置 缓存 的 生命 期 ,这 里 为 两 个 小 时 .如果 该 值 为 空 , 则 缓存 永久 有 效 。 
代码 的 第 2 行 设置 缓存 文件 存储 目录 。 

2. 缓存 对 象 

打开 applicationMBoostrap. php 引导 文件 ,在 初始 化 函数 initRegister 中 可 以 看 到 如 下 
代码 : 


$ frontOptions = array( 'leftTime'=> $ config[ 'cache'][ 'leftTime'], 
'automatic serialization'-» true); 
$ backOptions = array('cache dir'=> $ config['cache'][ cache dir']); 
$ cache = Zend Cache: :factory('Core', TFile', 
$ frontOptions, $ backOptions); 
Zend Registry::set('cache', $ cache); 
代码 的 第 1 句 设置 缓存 前 端 参 数 automatic serialization 表示 缓存 是 否 可 自动 序列 化 ， 
序列 化 后 可 存储 非 字符 数据 ; 代码 的 第 2 名 设置 后 端 存 储 目录 ; 代码 的 第 3 句 创 建 缓存 对 
象 , 缓 存 前 端 采 用 的 是 Core, 也 就 是 Zend_Cache_Core 类 ,后 端 采 用 的 是 File, 也 就 是 Zend | 
Cache_Backend_File 类 。 该 缓存 对 象 用 文件 存储 缓存 数据 ,并 将 文件 存放 到 application\ 


tmp 目录 中 。 
3. 缓存 对 象 的 使 用 
在 Common 控制 器 中 创建 test 方法 演示 缓存 的 使 用 ,下 面 是 test 方法 中 的 代码 : 


public function testAction() 
{ 
$ cache = Zend Registry::get('cache'); 
$ departCache- $ cache - > load( 'depart'); 
if(! $ departCache)( 
$ departModel - new Wm Model Depart(); 
$ depart = $ departModel - > getDeparts(); 
$ cache - » save( $ depart, 'depart'); 
}else ( 
echo < pre>'; 
print_r( $ departCache); 


echo '</pre>'; 


} 


程序 首先 从 注册 表 中 获取 缓存 对 象 , 然 后 调用 Zend. Cache. Core 类 的 load 方法 加 载 指 
定 的 缓存 数据 ; 如 果 指 定 的 缓存 不 存在 , 则 通过 调用 Zend Cache Core 类 的 save 方法 创建 
它 ,否则 直接 使 用 即 可 。 

4. 缓存 使 用 效果 

在 浏览 器 的 地 址 栏 中 输入 http://wmoams. com/common/test. 45$ 1 次 泻 染 页 面 ,创建 
depart 缓存 ,刷新 页 面 ,效果 如 图 12. 1 所 示 。 
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12.4 动作 助手 和 系统 缓存 的 实现 


12.3 节 介 绍 了 Zend Cache 缓存 的 原理 及 使 用 方法 ,本 节 实 现 系 统 的 缓存 功能 ,这 里 主 
要 实现 系统 的 页 面 缓存 。Zend Framework 应 用 中 的 页 面 缓存 可 以 通过 12. 3 节 介绍 的 方法 
实现 ,还 可 以 通过 “动作 助手 "实现 。 


12.4.1 Zend Framework 动作 助手 


通过 Zend Framework 提供 的 助手 模式 可 以 把 一 些 经 常 使 用 的 功能 模块 进行 封装 ,这 
样 就 可 以 在 需要 的 地 方 灵 活 使 用 。Zend Framework 中 有 两 种 助手 , 即 动作 助手 与 视图 助 
手 , 对 于 视图 助手 已 经 在 第 11 章 做 了 详细 的 介绍 。 

Zend Framework 的 动作 助手 可 以 向 任何 Zend. Controller. Action 的 派生 动作 控制 器 
中 即时 加 入 功能 ,以 使 增加 公共 的 动作 控制 器 功能 时 尽量 减少 派生 动作 控制 器 类 的 创建 。 
动作 助手 在 需要 调用 时 加 载 , 可 以 在 请 求 的 时 候 或 者 动作 控制 器 创建 的 时 候 实 例 化 。 常 见 
的 动作 助手 如 下 : 

* FlashMessenger: 用 来 处 理 Flash Messenger 会 话 ; 

Json: 用 来 解码 和 发 送 JSON 响应 ; 

Url: 用 于 创建 Urls; 

Redirector; 用 于 将 程序 重 定 向 到 内 部 或 者 外 部 页 面 ; 
ViewRenderer: 自动 完成 在 控制 器 内 建立 视图 对 象 


并 演 染 视图 的 过 程 ; pecans 
* AutoComplete: 自动 响应 AJAX 的 自动 完成 ; ieeete 
。 ContextSwitch、AjaxContext: 为 动作 提供 替代 响应 pna 
LE Dn 
。 Cache: 实现 缓存 的 相关 操作 ; Ed 
。 ActionStack: 用 于 操作 动作 堆栈 。 a 
这 些 动作 助手 存放 在 Zend Framework 库 文件 的 ZendN 
Controller\Action\ 目 录 中 ,如 图 12. 2 所 示 。 12.2 常见 动作 助手 
12.4.2 系统 缓存 的 实现 
1. 配置 缓存 


打开 application\cofigs\application. php 配置 文件 ,添加 如 下 代码 : 


resources. cachemanager. page. backend. options.public dir = APPLICATION PATH "/../public/cache" 

resources. cachemanager. pagetag. backend. options. cache dir - APPLICATION PATH "/../public/ 

cache/data/tags" 

resources. frontController. params.disableOutputBuffering = true 

以 上 配置 定义 了 两 个 目录 ,public_dir 用 来 存放 前 端 生成 的 缓存 文件 ,cache_dir 用 来 存 
放 后 端的 Tags 标识 。 最 后 一 行 用 于 关闭 程序 预 设 的 OutputBuffer 功能 ,以 避免 缓存 失效 。 
配置 的 缓存 目录 应 确保 已 经 存在 ,并 具有 写 和 权限 。 


2. 使 用 缓存 

经 过 以 上 配置 后 就 可 以 简单 使 用 缓存 了 ,只 需要 在 控制 器 的 init 初始 化 方法 中 使 用 动 
作 助 手指 定 要 缓存 的 页 面 ,并 为 其 指定 一 个 标识 即 可 。 

例如 ,在 Index, User, Document 控制 器 的 init 方法 中 分 别 添加 如 下 代码 : 


$ this -» helper -> cache(array( 'index', 'main'),array( 'defaultindex')); 
$ this—> helper -> cache(array( 'index', 'login'),array( defaultuser')); 
$ this-» helper- > cache(array( 'index', list', receive'), 
array( 'defaultdocument')); 
即 可 实现 这 些 控制 器 相应 页 面 的 缓存 。 代 码 中 的 cache 动作 助手 带 两 个 参数 ,前 一 个 是 要 
存储 的 缓存 页 面 ,后 一 个 是 为 这 些 页 面 指定 的 Tags 标识 。 
在 浏览 器 中 访问 上 述 缓存 的 控制 器 的 页 面 后 ,缓存 目录 中 的 内 容 如 图 12. 3 所 示 。 
4 (9 public 
4 $8 cache 
4 (9 data 
4 (95 tags 
国 zend cache-—nternal-m 
B zend cache---zend cach 
b $8 document 
b $8 index 
D (f user 
48) document.html 
B indexhtml 
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12.9 缓存 目录 内 容 


从 图 12. 3 可 以 看 出 ,在 浏览 器 访问 了 相应 缓存 页 面 后 ,缓存 目录 中 生成 了 一 些 目录 、 
HTML 缓存 页 面 和 一 些 没有 扩展 名 的 标记 文 记 ,并 且 这 些 内 容 仍然 是 按照 框架 的 层次 结构 
存储 的 ,显得 井然 有 序 。 

页 面 被 缓存 之 后 ,如 果 有 下 一 个 请 求 再 访问 该 页 面 ,框架 会 首先 到 public\cache 目录 下 
按照 URL 的 组 织 方式 查找 对 应 的 HTML 文件 ; 如 果 找 到 ,直接 输出 该 HTML; 如 果 没 找 
到 , 交 给 框架 ,按照 原来 的 路 由 流程 进行 处 理 。 


12.5 系统 的 完善 


通过 前 面 章 节 的 介绍 ,本 书 案例 项 目 一 一 微 梦 办 公 自 动 化 管理 系统 一 一 的 基本 功能 
实现 完毕 ,其 他 功能 模块 的 实现 与 前 面 讲 的 大 同 小 异 , 和 希望 大 家 在 此 基础 上 继续 完成 余 
下 的 工作 。 

由 于 本 书 重点 介绍 Zend Framework 框架 及 组 件 的 使 用 ,所 以 在 系统 设计 中 采用 的 是 
一 些 最 基础 的 .最 简单 的 业务 处 理 逻 辑 。 这 样 ,程序 代码 可 能 不 太 严 说, 甚至 有 些 元 余 ,业务 
处 理 逻 辑 有 时 可 能 会 显得 比较 策 拙 ,希望 大 家 在 学 习 过 程 中 结合 自己 的 实际 情况 对 页 面 布 


局 .数据库 设 计 以 及 业务 处 理 逻辑 进行 适当 的 完善 。 = 
本 节 介 绍 Web 应 用 中 的 图 形 验证 码 .系统 日 志 及 数据 备份 的 实现 。 12 
章 


用 户 权 限 及 系统 优化 


PHP Zend Framework 5 A F E s RUHE 


12.5.1 验证 码 


为 了 防止 非法 用 户 通 过 恶意 程序 采用 试探 密码 的 方式 登录 本 系统 ,或 连续 向 数据 表 中 
注入 垃圾 信息 ,应 该 在 系统 登录 ,发 布 公文 .添加 消息 、 添 加 事务 等 操作 过 程 中 添加 验证 码 
信息 。 

在 Web 应 用 中 ,验证 码 可 以 有 多 种 形式 ,例如 文字 验证 码 、 图 片 验 证 码 ,语言 验证 码 等 ， 
下 面 采用 Web 应 用 中 最 常用 的 验证 码 形式 ( 即 图 片 验 证 码 ) ,来 实现 系统 后 台 管理 中 心 的 登 
录 验 证 功能 。 为 了 简单 ,这 里 只 实现 验证 码 功 能 ,效果 如 图 12.4 所 示 。 
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12.4 后 台 管 理 中 心 登录 验证 


本 系统 后 台 管 理 中 心 的 登录 验证 是 在 前 台 页 面 中 进行 的 。 当 用 户 通 过 认证 进入 系统 
后 ,如 果 用 户 具有 管理 权限 , 则 会 在 页 面 的 项 部 显示 “进入 系统 后 台 管 理 中 心 ”超级 链接 , 单 
击 该 链接 ,显示 如 图 12.4 所 示 的 验证 页 面 。 

l. 编写 验证 人 码 类 

使 用 PHP 语言 制作 图 片 验 证 码 可 以 使 用 GD2 函数 。 考 虑 到 验证 码 的 高 度 、 宽 度 以 及 
图 片 中 文字 的 字体 在 不 同类 型 的 表单 中 可 能 存在 差异 ,这 里 单独 将 验证 码 的 实现 过 程 封 装 
成 验证 码 类 。 

打开 Zend Studio 集成 开发 环境 ,在 项 目 wmProject 中 添加 新 的 子 目 录 application\ 
pluginsNutil, 并 添加 名 为 ValidateCode. php 的 文件 ,在 文件 中 创建 一 个 名 为 Wm_Plugin_ 
Util, ValidateCode 的 自 定义 类 。 其 代码 如 下 : 


class Wm Plugin Util ValidateCode 
1 


private $ width; // 验 证 码 图 片 宽度 
private $ height; // 验 证 码 图 片 高 度 
private $ codeStr; // 验 证 码 

private $ fontType; // 验 证 码 字体 类 型 
private $ img; // 验 证 码 图 像 句 柄 


public function ^ construct ( $ width, $ height, $ codeStr = '0000', $ fontType = 0) 
t 
$this-» width- $ width; 
$this-» height- $ height; 
$ this-» codeStr = substr( $ codeStr,0,4); 
$ this—> fontType- $ fontType; 
) 
private function getColor ( $ x, $ y) // 获 取 颜 色 
{ 


$r=mt_rand( $x, $ y); 

$g=mt rand( $x, $ y); 

$b-nt rand( $ x, $ y); 

return imagecolorallocate( $ this- » img, $r, $g, $b); // 返 回 颜 色 句柄 
} 


private function _init () // 创 建 初始 图 像 
$this-» ing- imagecreate( $ this -» width, $ this-» height); 

ENN function _build () // 创 建 验证 码 

i // 为 图 像 填 充 背景 色 


imagefill( $ this->_img,0,0, $ this —» getColor(150,250)); 
// 创 建 一 个 矩形 作为 验证 码 的 边框 
imagerectangle( $ this—> img,0,0, $ this- » width — 1, 
$this-» height - 1, $ this- » getColor(50,150)); 
if($this-» fontType == 0) ( 
$ fontFileName = 'ARIALBI. TTF'; // 设 置 验证 码 文字 的 字体 
) else ( 
$ fontFileName = 'ARIALN. TTF'; 
) 
// 绘 制 文字 
for ($i=0; S$i«strlen($this-» codeStr); $i++){ 
imagettftext( $ this -» img,mt rand(12,24),0, 
($this-» width) / 4 * $i,mt rand(20, $ this-» height - 5), 
$ this-» getColor(10,180), APPLICATION PATH. 
'/resources/font/'. $ fontFileName, 
substr( $ this - » codeStr, $ i,1)); 
) 
// 绘 制 15 条 干扰 线 
for ($i=0; $i<15; $i++){ 
imageline( $ this—> img,mt rand(0, $ this- » width), 
mt rand(0, $ this- » height),mt rand(0, $ this- » width), 
mt rand(0, $ this- » height), $ this—- » getColor(110,210)); 
) 
) 
// 显 示 图 像 
public function show () 
{ 
header( 'content - type: inage/png') ; // 设 置 输出 图 片 的 格式 
$this-» init(); 
$this-» build(); 
imagepng( $ this — > img); // 输 出 图 片 


上 述 代 码 使 用 的 都 是 PHP 函数 ,比较 简单 ,请 读者 结合 注释 自行 理解 ,这 里 要 注意 验 


证 码 类 的 名 字 与 其 存放 的 目录 及 文件 名 之 间 的 联系 。 在 第 2 章 中 已 经 介绍 过 , Zend 
Framework 框架 具有 自动 加 载 的 功能 ,如 果 自 定义 类 符合 特定 的 规则 ,在 程序 中 使 用 这 些 | 章 
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类 时 就 不 需要 使 用 像 include 这 样 的 包含 语句 。 

另外 ,验证 码 字体 存放 在 项 目的 application\resources\font 目录 中 ,请 大 家 参考 教材 源 
代码 。 

2. 封装 验证 码 表单 元 素 

由 于 验证 码 一 般 和 表单 元 素 一 起 使 用 ,也 就 是 说 , 它 往往 是 表单 中 的 一 部 分 。 为 了 使 用 
方便 , 自 定 义 一 个 名 为 Wm_Plugin_Form_Element_Vcode 的 表单 元 素 类 ,并 将 其 存放 在 
applicationVpluginsMormVelement 目录 中 ,代码 如 下 : 


//Vcode. php 文 件 
class Wm Plugin Form Element Vcode extends Zend Form Element Xhtml 
{ 
public $ helper = 'formVcode'; 
} 


从 代码 中 可 以 看 出 ,该 类 继承 于 Zend_Form_Element_Xhtml 类 ,因而 具有 了 Zend_ 
Form 表单 的 所 有 功能 。 另 外 ,该 代码 还 为 “验证 码 ? 表 单元 素 定义 了 一 个 名 为 formVcode 
的 视图 助手 。 

3. 添加 验证 码 表 单元 素 视图 助手 

打开 application\views\helpers 目录 ,添加 新 文件 FormVcode. php, 创 建 名 为 formVcode 视 
图 助手 ,代码 如 下 : 


class Zend_View_Helper_FormVcode extends Zend_View_Helper_FormElement 
{ 
public function formVcode ( $ name, $ value = null, $ attribs = null) 
{ 
$ xhtml = '< input type = "text" name="'. $name. '""id-"'. 
$name. '" maxlength="4" value-"'. $value. " '; 
if (isset( $ attribs[ textStyle'])) { 
$ xhtml . = 'style="'. $attribs['textStyle'] . '" '; 
} 
if (isset( $ attribs[ 'textClass'])) ( 
$ xhtml .= 'class="'. $attribs['textClass'] . '" '; 
) 
$ xhtml . = '/>'; 
$ xhtml. = «img id = "vcodeImg" src-"'. $ this-> view- > baseUrl() 
. '/common/vcode" '; 
if (isset( $ attribs[ 'imageStyle'])) ( 
$ xhtml . = 'style="'. $attribs['imageStyle'] . '" '; 
} 
if (isset( $ attribs[ 'imageClass'])) ( 
$ xhtml .= 'class-"'. $attribs['imageClass'] . '" '; 
) 
$ xhtml . = '/>'; 
$ xhtml . = «span '; 
if (isset( $ attribs[ 'spanStyle'])) { 
$ xhtml .= 'style="'. $attribs['spanStyle'] . ™ '; 
} 
if (isset( $ attribs['spanClass'])) { 


$ xhtml .= 'class="'. $attribs['spanClass'] . '" '; 


) 
$ xhtml . = '/>'; 
$ xhtml . = <a href = "javascript:'. $ attribs['functionName'] 


. "| class="'. $attribs['aClass'] . "> 看 不 清 , 换 一 张 </a>'; 
$ xhtml . = '</span>'; 
return $ xhtml; 
) 
) 


上 述 阴影 部 分 的 代码 表示 验证 码 在 页 面 中 的 图 片 显示 。 从 这 里 可 以 看 出 ,验证 码 来 自 
于 Common 控制 器 的 vcode 方法 。 

4. 添加 验证 码 表单 元 素 验证 器 

前 面 在 使 用 Zend Form 表单 元 素 时 都 使 用 了 一 些 验证 器 ,例如 非 空 验证 ,字符 长 度 验 
证 等 ,也 可 以 为 上 述 自 定义 的 验证 码 表 单元 素 添加 验证 器 。 

打开 application\plugins\validate 目录 ,添加 新 文件 VcodeRight. php. 8]££ 4 JJ VcodeRight 
的 表单 元 素 验 证 器 ,代码 如 下 : 


class Wm Plugin Validate VcodeRight extends Zend Validate Abstract 
{ 
// 设 置 错误 信息 的 键 名 
const ERRORMESSAGE = 'notRight'; 
// 设 置 错误 信息 
protected $ messageTemplates = array( 
self: :ERRORMESSAGE = > "KruE B i A f UR! 
) 
// 实 现 接口 的 isValid( ) 方 法 ,对 输入 数据 进行 验证 
public function isValid ( $ value) 
( 
$ this- » setValue( $ value); 
$ sessionNamespace = new Zend Session Namespace( session'); 
if (trim(strtolower( $ value)) != 
strtolower( $ sessionNamespace - > validateCode)) ( 
$ this-» error(self::ERRORMESSAGE) ; 
return false; 
) 


return true; 


} 


代码 中 的 基 类 Zend Validate Abstract 为 抽象 类 , 它 实 现 了 Zend_Validate_Interface 
接口 ,因而 是 一 个 Zend Framework 的 验证 器 ,在 验证 时 将 用 户 输 入 的 验证 码 与 会 话 中 存储 
的 信息 进行 比 对 。 

5. 添加 验证 码 控制 器 方法 

在 Common 控制 器 中 添加 vcode 方法 ,代码 如 下 : 


public function vcodeAction() 第 
12 
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$w-7 $ this -> getRequest() - » getParam('w'); 
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$ h= $this-»getRequest() -> getParam('h'); 
$ f= $this-»getRequest() -» getParam( 'f ') ; 
if ( $ w== null) { 
$w-80; 
) 
if ( $ h== null) { 
$ h=35; 
} 
if ( $ f == null) { 
$f=0; 
} 
$ codeStr = ""; 
oO 
J KL M,N','0','P','Q',R','S', TT, U,V WX YY,'2); 
for ($i=0; $i<4; $i++){ 
$ codeStr . = $ codeArray[mt_rand(0,35)]; 
} 
$ sessionNamespace = new Zend Session Namespace( 'session'); 
$ sessionNamespace - > validateCode = $ codeStr; 
$ validateCode = new Wn Plugin Util ValidateCode( $ w, $ h, $ codeStr, $ f); 
$ validateCode - > show( ) ; 


$ this- >_helper -> layout - > disableLayout(); 
$ this ->_helper 一 > viewRenderer -> setNoRender( ) ; 
} 


阴影 部 分 代码 完成 验证 码 的 输出 与 文本 的 保存 。 验 证 码 文 本 保存 在 session 会 话 空间 
中 ,以 备 在 Wm Plugin Validate VcodeRight 验证 器 中 与 用 户 的 输入 进行 比 对 。 

6. 创建 登录 表单 

使 用 前 面 章节 中 介绍 的 方法 创建 用 户 登录 系统 管理 中 心 验证 表单 ,代码 如 下 : 


class Wm_Form AdminLogin extends Zend_Form 
public function init() 
( 
$ this -> setName( 'form adminlogin') 
一 > setMethod( 'post') 
一 > addAttribs(array( 
'style' => 'margin:0px; padding:Opx" 

)) 


$ this - > addElements(array( 
new Wm_Plugin_Form_Element_Vcode( 'vcode', array( 

'required' => true, 

'label'=> ' 验 证 码 : , 

"attribs'=> array( 
'textClass' 22 '', 
'textStyle'- »'position:relative; 

left:20px; top:0px; width:60px; 
height:18px; line- height:18px; ', 


'imageStyle' = >'position:relative; 
left:50px; top:15px;', 
'spanStyle' => 'position:relative; 
top:25px; height:18px; ', 
'aClass' => 'a4', 
'functionName' => 'changeValidateCode()" 
) 
'filters' => array( 'StringTrin'), 
"validators'=> array( 
array( 'NotEmpty', true, 
array('nessages' => ' 请 输入 验证 码 '))， 
new Wn Plugin Validate VcodeRight() 
) 
'decorators' => array( 
"ViewHelper', 
'Errors', 
array('HtmlTag',array('tag'-» 'td', 
'style' => 'height:30px; ')), 
array('Label',array('tag' => 'th')) 
) 
), 
new Zend Form Element Image( submitImage',array( 
'required' => false, 
"abel'=> '', 
'src' => '/images/btn login.gif', 
'attribs' => array( 
'style' => 'position:relative; 
left:20px; top:lOpx;' 
) 
"decorators'=> array( 
'ViewHelper', 
array('HtmlTag',array('tag'-» 'td', 
'style' => 'height:55px; ')), 
array('Label',array('tag'-» 'th')) 


) 
)) 
$ this - > setDecorators(array( 
"FormElements', 
array( 'HtnlTag', array( 'tag' = »'table', 'Cclass' = »'sheet')), 
"form 


)); 
) 


这 里 调用 Zend Form 的 addElements 方法 通过 直接 创建 表单 元 素 对 象 来 添加 表单 元 
素 。 其 详细 用 法 请 大 家 参考 第 4 章 的 有 关内 容 。 

阴影 代码 中 的 第 1 句 使 用 前 面 自 定义 的 “验证 码 ” 表 单元 素 类 Wm_Plugin_Form_ 
Element_Vcode 在 表单 中 创建 验证 码 , 并 用 数组 的 方式 添加 相应 的 表单 元 素 属性 。 阴 影 代 
码 中 的 第 2 句 定义 了 一 个 JavaScript 函数 名 changeValidateCode, 它 是 用 户 单 击 验 证 码 旁 
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边 的 “看 不 清 , 换 一 张 "链接 后 的 操作 实现 函数 。 


第 3 块 阴 影 代码 为 “验证 码 ” 表 单元 素 设置 验证 器 ,这 里 设置 了 两 个 验证 器 ,一 个 是 非 空 


验证 器 'NotEmpty', 这 是 Zend Framework 预定 义 验 证 器 ,在 前 面 的 章节 中 已 经 多 次 使 用 ， 
它 的 错误 提示 信息 为 “请 输入 验证 码 ” 另 一 个 验证 器 为 类 Wm | Plugin | Validate _ 
VcodeRight 的 对 象 , 即 自 定义 的 “验证 码 ” 验 证 器 , 它 的 错误 提示 信息 为 “验证 码 输 入 错误 !1” 
文本 。 


接 下 来 的 第 4 块 阴 影 代码 设置 “验证 码 ” 表 单元 素 装 饰 器 。'ViewHelper' 用 我 们 自 定义 


的 formVcode 视图 助手 来 解析 “验证 码 ” 表 单元 素 ; 'Errors' 解 析 验 证 器 错误 提示 信息 。 最 
后 的 阴影 部 分 代码 用 Zend. Form 图 片 元 素 代替 表单 的 “提交 ”按钮 ,以 增强 页 面 的 效果 。 


7. 创建 登录 控制 器 方法 
在 User 控制 器 中 添加 adminlogin 方法 ,代码 如 下 : 


public function adminloginAction() 
{ 
$ adminLogin = new Wm Form AdminLogin(); 
if ( $ this -> getRequest() -> isPost()) ( 
$ formData = $ this- > getRequest() -> getPost(); 
if ( $ adminLogin-> isValid( $ formData)) { 


} 
} 


$ this -> view- > adminLoginForm = $ adminLogin; 
) 


该 方法 输出 登录 表单 ,接收 并 处 理 用 户 的 输入 。 阴 影 代 码 为 表单 验证 , 即 调用 上 面 6 中 


设置 的 “ 非 空 ”与 “验证 码 输入 错误 ”两 个 验证 器 。 


8. 设计 登录 页 面 视图 
打开 系统 管理 中 心 登录 视图 文件 application\views\scripts\user\adminlogin. phtml, 


将 原 有 代码 修改 为 : 


12. 


<br /><br /> 
<hl > 后 台 管 理 中 心 登录 验证 </hl > 
<hr /><br /> 
<?php echo $ this -> adminLoginForm ?> 
«script» 
function changeValidateCode()( 

var vcode = document. getElenentById("vcodeIng"); 

vcode. src = "<?php echo $ this -> baseUrl( 

'/common/vcode/rand/" + Math. randon() + "')?2"; 

j 


</script> 

注意 : 代码 中 的 阴影 部 分 ,它们 实现 登录 表单 的 显示 与 验证 码 的 变换 。 

5.2 系统 日 志 

系统 日 志 即 系统 运行 的 工作 记录 。 记 录 并 读 取 系 统 日 志文 件 , 对 于 了 解 系统 的 运行 状 


态 、 出 现 的 异常 以 及 访问 情况 等 都 是 很 有 必要 的 。 在 Zend Framework 中 提供 了 Zend Log 
组 件 用 于 执行 对 系统 日 志文 件 的 操作 。 

1. Zend_Log 组 件 

Zend Log 是 一 个 通用 日 志 组 件 ,该 组 件 支持 多 个 日 志 后 端 ,格式 化 发 送 给 日 志 的 消息 、 
过 滤 被 记录 的 消息 等 。 该 组 件 包 括 以 下 4 个 对 象 : 

1) Log 对 象 

Log 对 象 即 Zend Log 类 的 实例 , 它 是 应 用 程序 使 用 最 多 的 对 象 。 根 据 实际 需要 ,可 以 
创建 任意 多 个 Log 对 象 , 不 同 的 Log 对 象 之 间 不 会 相互 影响 。 一 个 Log 对 象 必须 至 少 包含 
一 个 Writer( 容 器 ) 对 象 ,还 可 以 选择 包含 一 个 或 多 个 Filter( 过 滤器 ) 对 象 。 

2) Writer 对 象 

Writer 对 象 继承 于 Log 容器 抽象 类 Zend Log. Writer. Abstract. f 9€ [8] ££ fiti A ue 'P f 
TEH dE. "f Hg Zend Log Writer Stream, Zend. Log Writer Null, Zend | 
Log Writer Db 以 及 Zend Log. Writer Mock 对 象 等 。 

3) Filter X] 

Filter 对 象 实现 了 Log 过 滤器 接口 Zend Log Filter Interface. it WË BE f ££ B H E 
据 。 一 个 Filter 对 象 可 以 应 用 到 多 个 Writer 对 象 中 ,或 者 在 所 有 Writer 之 前 应 用 一 个 Log 
对 象 ,这 样 多 个 Filter 过 滤器 对 象 可 以 串联 起 来 。 

4) Formatter 对 象 

Formatter 对 象 实现 了 Log 数据 格式 化 接口 Zend_Log_Formatter_Interface, 负 责 在 由 
Writer 写 人 数据 之 前 对 日 志 数据 的 格式 化 。 每 一 个 Writer 对 象 只 能 有 一 个 Formatter 格 
式 化 对 象 。 

2. Log 对 象 的 创建 与 使 用 

1) 创建 对 象 

如 果 要 创建 Zend Log 对 象 ,只 需要 简单 地 使 用 new 运算 符 调 用 Zend. Log 类 的 构造 
方法 即 可 。 注 意 , 一 个 Zend_Log 对 象 必 须 至 少 有 一 个 Writer 对 象 , Writer 对 象 可 以 通过 
Zend. Log 类 的 构造 方法 带 入 ,也 可 以 调用 Zend_Log 类 的 addWriter 方法 添加 。 例 如 : 


$ writer = new Zend_Log_Writer_Stream( 'php://output'); 
$ log = new Zend Log( $ writer); 


或 者 : 


$ writer = new Zend Log Writer Stream( 'php://output'); 
$ log = new Zend Log(); 
$ log - » addWriter( $ writer); 


2) 使 用 日 志 信息 

Zend. Log 对 象 在 创建 成 功 之 后 就 可 以 向 其 中 添加 日 志 信 息 了 。 日 志 信息 的 添加 是 通 
过 Zend. Log 类 的 log 方法 完成 的 ,使 用 该 方法 还 可 以 设置 日 志 信息 的 类 型 。 其 语法 格式 
如 下 : 

log( $ nessage, $ priority) 


其 中 ,参数 message 为 需要 记录 的 信息 内 容 , 以 字符 串 表示 ; 参数 priority 为 信息 类 型 ， 
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也 称 为 信息 等 级 ,用 Zend Log 常量 表示 。Zend Framework 的 内 部 日 志 等 级 有 8 种 ,分 别 
Jj EMERG,ALERT,CRIT,ERR, WARN,NOTICE,INFO ftl DEBUG., 

用 户 除 了 可 以 使 用 log 方法 之 外 ,还 可 以 使 用 与 消息 等 级 同名 的 方法 , 且 使 用 这 些 方 法 
时 不 必 给 消息 指定 等 级 ,消息 会 自动 创建 该 等 级 的 消息 。 例 如 : 


$ writer = new Zend Log Writer Stream('php://output'); 
$ log = new Zend Log( $ writer); 
$ log - » log( 'R At H WIR — ', Zend. Log: : INFO) ; 


或 者 : 


$ writer = new Zend Log Writer Stream('php://output'); 
$ log = new Zend Log( $ writer); 
$ log - » info( ' 系 统 日 志 测试 … '); 


3) 销毁 日 志 对 象 

如 果 某 个 Zend Log 对 象 不 再 需要 ,可 以 将 该 对 象 销 毁 。 如 果 要 销毁 一 个 Zend_Log 对 
象 , 只 需要 为 其 赋值 Null 即 可 。 在 Zend_Log 对 象 被 销毁 前 会 自动 调用 每 个 附加 在 Log 上 
的 Writer 的 shutdown 方法 ,释放 其 所 占 的 系统 资源 。 

3. 系统 日 志 的 实现 

下 面 以 用 户 登 录 系 统管 理 中 心 为 例 实 现 系统 的 日 志 功 能 。 当 用 户 通过 图 12. 4 所 示 的 
验证 后 ,进入 系统 管理 中 心 页 面 ,此 时 ,在 系统 日 志文 件 中 记录 用 户 登 录 信息 ,包括 登录 时 
间 、 用 户 姓 名 、 所 属 部 门 等 。 

在 User 控制 器 的 adminlogin 方法 中 添加 如 下 代码 : 


public function adminloginAction() 
{ 
$ adminLogin = new Wm Form AdminLogin(); 
if ( $ this -> getRequest() -> isPost()) ( 
$ formData = $ this -> getRequest( ) -> getPost(); 
if ( $ adminLogin -> isValid( $ formData)) { 
$ logDir = APPLICATION PATH. '/logs/'.date('Y- m- d'). /'; 
$ folder - new 
Zend Search Lucene Storage Directory Filesystem( 
$ logDir); 
$ fileName- $ logDir. wm log login.txt'; 
$ file= fopen( $ fileName, 'a'); 
$ writer = new Zend Log Writer Stream( $ file); 
$ log = new Zend Log( $ writer); 
$str- $this--» user - » getIdentity() -> username; 
$str.-'**** '. $this-» user -> getIdentity() -> department; 
$str.- e 登录 系统 管理 中 心 '; 
$ log - » log( $ str, Zend Log: :INFO); 
$ this -> redirect( '/adnin/user/list'); 
) 
} 
$ this -> view- > adminLoginForm = $ adminLogin; 


日 志 信 息 的 存储 方式 (也 就 是 Log 的 Writer 对 象 ) 可 以 有 多 种 类 型 ,常用 的 有 文件 及 数 
据 库 两 种 方式 。 这 里 采用 文件 的 存储 形式 ,文件 名 为 wm. log login. txt, 位 于 application\ 
logs\year-month-day\ 目 录 下 。 

代码 首先 创建 日 志 目录 及 文件 ,然后 以 追加 的 方式 打开 日 志文 件 ; 接着 创建 Log 对 象 
及 其 Writer 容器 对 象 ; 最 后 将 日 志 信息 写 入 日志 文件 中 ,效果 如 图 12. 5 所 示 。 


4 (S wmProject 
4 (9 application 
b (9 backup 
» $9 configs 
» $9 controllers 
» (9 forms 
b Q9 layouts 
4 (9 logs 
4 (9 2014-09-19 
上 wm.log.logintxt 
b (98 2014-09-20 
b (9 models 


El wm log. login.b 23 
12014-09-19T09:08:29«08:00 INFO (6): WEE * FHAR t ER REIR G 
22014-09-19T09:11:25408:00 INFO (6): WEF IMALE FR RR D 
32014-09-19T10:17:13*08:00 INFO (6): WEE * Up HERR RR 
4 


12.5 日 志 目 录 结构 及 文件 详情 


12.5.3 数据 备份 


对 于 Web 应 用 来 说 ,数据 备份 的 重要 性 是 毋庸 置疑 的 。 数 据 库 的 备份 一 般 包 括 完全 备 
份 . 事 务 日 志 备份 .差异 备份 与 文件 备份 4 种 类 型 ,用户 应 根据 具体 情况 选用 。 

数据 库 备 份 的 方式 有 很 多 ,可 以 直接 采用 数据 库 的 命令 形式 ,也 可 以 采用 PHP 编程 的 
方式 。 下 面 简单 介绍 以 PHP 编程 的 方式 备份 整个 数据 库 及 下 载 单 个 数据 表 数 据 的 方法 。 

1. 设计 视图 

使 用 前 面 章 节 中 介绍 的 方法 在 admin 模块 中 创建 Backup 控制 器 ,并 在 其 中 添加 
dbbackup .dbdownload 及 store 方 法 ,编写 视图 文件 代码 。 

1) index. phtml 文件 


<br /><br /> 

<p> 系 统 数据 备份 </p> 

<hr /> 

<p><a href = "/admin/backup/dbbackup"> 数 据 库 备份 </a> gnbsp; gnbsp; 对 系统 数据 库 进行 备份 , 文 
件 格式 为 sql </p> 

<hr /> 

<p><a href ="/admin/backup/dbdownload"> 数 据 表 下 载 </a> gnbsp; gnbsp; 对 系统 数据 库 中 的 数据 
下 载 备 份 , 文 件 格式 为 txt </p> 

<hr /> 


当 用 户 在 系统 后 台 管 理 中 心中 单 击 左 侧 快 捷 菜 单 中 的 “其 他 信息 管理 ”1“ 数 据 备 份 " 菜 


单项 后 ,进入 如 上 代码 所 示 的 index. phtml 主页 面 。 该 页 面 中 设置 了 “数据 库 备份 与 “数据 
表 下 载 "两 个 超级 链接 ,分 别 完成 数据 库 整体 备份 与 部 分 数据 下 载 备份 功能 。 
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2) dbbackup. phtml 文件 


<br /><br /> 

<p> 数 据 库 备份 </p> 

<hr /><br /> 

< form method = "POST" action= ""> 

< input type = "text" name = "filename" value = "<?php echo 'Db '.date( 'Ymd').'.sql'?>" /> 
&nbsp; &nbsp; &nbsp; &nbsp;« input type = "submit" value = "备份 " /> 

</form> 


在 上 述 “ 数 据 库 备份 ”页面 代码 中 设置 了 一 个 表单 来 接收 数据 库 备 份 文件 名 ,这 里 默认 
为 “Db 年 月 日 . sql”。 
3) dbdownload. phtml 文件 


<br /><br /> 
<p> 下 载 数据 表 </p> 
<hr /><br /> 
< form method = "POST" action = " "> 
< select name = "table" 
<?php foreach ( $ this -> dbtables as $arry table)( 
foreach ( $ arry table as $ key => $ table)( 


?> 
< option value = "<?php print( $ table); ?>"> 
<?php print( $ this -> tableName( $ table)); ?></option> 
<?php }} ?> 
</select> 


&nbsp; &nbsp; &nbsp; &nbsp;< input type = "submit" value = "Fk" /> 
&nbsp; &nbsp; &nbsp; &nbsp;< input type = "reset" value= "取消" /> 
</form> 


在 用 户 下 载 数据 表 中 的 数据 时 必须 确定 数据 表 的 名 称 ,这 里 通过 HTML 的 “选择 ” 表 
单元 素来 完成 该 项 功能 ,如 图 12.6 所 示 。 选 择 列表 中 的 数据 表 名 来 自 于 Backup 控制 器 的 
dbdowmload 方法 ,列表 中 的 文本 来 自 于 tableName 视图 助手 ,其 代码 如 下 : 


class Zend View Helper TableName 
( 
public function TableName ( $ name) 
{ 
$ tableName = ''; 
switch ( $ name) { 
case 'tb docs': 
$ tableNane = ' 公 文 数据 ';break; 
case 'tb users': 
$ tableName = ' 用 户 数据 ';break; 
case 'tb affair': 
$ tableName = ' 事 务 数据 ';break; 
case 'tb_userfile': 
$ tableNane = ' 用 户 文件 '; break; 
default: 
$ tableName = '… '; break; 


return $ tableName; 


} 


该 视图 助手 通过 数据 表 名 获取 列表 项 的 描述 文本 , 即 用 户 需要 下 载 的 数据 类 型 。 对 于 
视图 助手 的 定义 请 读者 参考 第 10 章 中 的 相关 内 容 。 

创建 完 M-V-C 各 部 件 后 ,就 可 以 在 浏览 器 中 预览 页 面 效果 了 ,如 图 12.6 所 示 。 该 图 中 
左 、 中 、 右 部 分 分 别 为 index. phtml、dbbackup. phtml、dbdownload. phtml 页 面 。 


系统 数据 备份 数据 库 备份 下 载 数 据 表 


PUE RD 对 系统 数据 库 进 行 备份 ， 文 件 格式 为 sql 


Db_20150615.sql 备份 


T) (mA) 


孝 据 志 下 载 对 系统 数据 库 中 的 数据 下 载 备份 ， 文 件 格式 为 txt 


图 12.6 数据 备份 页 面 效果 


2. 实现 数据 库 备 份 
在 Backup 控制 器 中 初始 化 一 个 数据 库 适 配器 ,并 在 dbbackup 方法 中 添加 代码 : 


class Admin BackupController extends Zend Controller Action 
( 
protected $ db- null; 
public function init() 
{ 
$ this—> db- Zend Db Table Abstract: :getDefaultAdapter( ) ; 
$this-» helper-» layout() -> setLayout( 'admin'); 
) 


public function dbbackupAction() 
( 
if( $ this -> getRequest() - > isPost()){ 
$ filename = $ this -> getRequest() — > getParan( 'filename'); 
$ backupDir = APPLICATION PATH. '/backup/'; 
$ folder = new Zend Search Lucene Storage Directory Filesystem( $ backupDir); 
$ sql = 'd:\xampp\MySQL\bin\mysqldump — h127.0.0.1 
— uroot - p123456 db_wmoams > '. $ backupDir. $ filename; 


exec( $ sq1); 
echo "< script» alert(' 备 份 成 功 '); 
location = '/admin/backup' «/script >"; 第 
} 12 
} x* 


用户 权限 及 系统 优化 


PHP Zend Framework 9i A 7F X X HEPKE 


) 

如 果 要 对 数据 库 进 行 备 份 , 必 须 获取 数据 库 适 配器 。 本 系统 的 数据 库 适 配器 是 在 配置 
文件 中 设置 的 ,这 里 通过 Zend Db Table Abstract 类 的 静态 方法 getDefaultAdapter 得 到 。 

fr PHP 中 备份 数据 库 ,通过 调用 exec O 函数 执行 系统 命令 来 完成 。 代 码 中 的 参数 为 
作者 本 地 环境 参数 ,在 实际 应 用 时 应 适当 调整 。 


3. 下 载 数 据 表 数据 
在 Backup 控制 器 的 dbdownload 方法 中 添加 代码 : 


public function dbdownloadAction() 
{ 
$ tableObj- $ this- >_db- > query( 'SHOW TABLES") ; 
$ tables = $ table0bj -> fetchAll(); 
if( $ this - > getRequest() 一 > isPost()){ 
$ tableName = $ this -> getRequest() -> getParam( 'table'); 
$ filename = $ tableName.date( 'Ymd'). '.txt'; 
$ this -> redirect( '/adnin/backup/store/tableName/' 
. $ tableName. '/fileName/'. $ filename); 
} 
$ this -> view-> dbtables = $ tables; 
) 
public function storeAction() 
( 
$ fileName- $ this -> getRequest() - > getParan( 'fileName'); 
$ tableNane = $ this - > getRequest() - > getParan( 'tableName'); 
header( Content - Type: application/octet - stream'); 
header('Content - Disposition: attachment; filename = '. $ fileName); 
$ select = new Zend Db Select( $ this -» db); 
$ select 一 > from( $ tableName); 
$rs- $ select -»query(); 
for($i=0; $i« $rs-»columnCount(); $ i++){ 
$ data= $ rs- » getColumnMeta( $ i); 
print( $ data[ 'nane']. "V t"); 
) 
print("Wn"); 
$ row- $ rs--fetch(PDO::FETCH NUM); 
while( $ row)( 
for($i-20; $i« $rs-»columnCount(); $ i++){ 
print(mb convert encoding( $ row[ $ i], 
'gb2312', 'UTF - 8')."\t"); 
) 
$ row= $rs-»fetch(PDO::FETCH NUM); 
print("An"); 


$this-» helper -> layout - > disableLayout(); 
$ this-» helper -> viewRenderer - > setNoRender() ; 


) 
这 里 将 下 载 页 面 的 显示 与 数据 的 下 载 分 别 用 两 个 不 同 的 方法 实现 。 代 码 中 的 第 1 句 阴 
影 部 分 通过 数据 库 适 配器 查询 得 到 系统 数据 库 的 所 有 数据 表 ; 第 2 块 阴 影 部 分 设置 下 载 页 
面 类 型 及 备份 文件 名 称 ; 第 3 句 阴影 代码 获取 下 载 数据 表 数 据 ; 第 4 句 阴影 代码 将 数据 表 


字段 名 写 入 文件 中 ; 最 后 第 5 句 阴影 代码 写 人 文件 的 是 数据 表 中 的 数据 记录 。 
12.6 本 章 小 结 


本 章 实现 办 公 自 动 化 管理 系统 的 访问 控制 .缓存 等 Web 应 用 的 安全 、 性 能 优化 技术 方 
案 , 并 对 系统 进行 了 简要 的 完善 ,包括 图 形 验证 码 、 系 统 日 志 , 数 据 备份 等 。Zend Framework 
应 用 的 访问 控制 以 及 数据 和 页 面 的 缓存 由 Zend_Acl 及 Zend_Cache 组 件 完 成 。 

本 章 重点 掌握 Zend Framework 框架 的 角色 、 资 源 、 控 制 列 表 等 基本 概念 ,访问 控制 规 
则 的 设置 以 及 使 用 插件 实现 访问 控制 的 方法 ; 对 于 Zend. Cache 缓存 组 件 ,重点 掌握 其 工作 
原理 以 及 前 端 .后 端的 概念 和 相关 类 方法 的 使 用 。 
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